=============
field_by_name
=============

.. js:function:: field_by_name(field_name)

**domain**: client 

**language**: javascript

**class** :doc:`Item class </refs/client/item_api>`

Description
===========

Call ``field_by_name`` to retrieve field information for a field when only its 
name is known. 

The ``field_name`` parameter is the name of an existing field. 

``field_by_name`` returns the field object for the specified field. If the 
specified field does not exist, ``field_by_name`` returns ``null``.