==============
filter_by_name
==============

.. js:function:: filter_by_name(filter_name)

**domain**: client 

**language**: javascript

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

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

Call ``filter_by_name`` to retrieve filter information for a filter when only its 
name is known. 

The ``filter_name`` parameter is the name of an existing filter. 

``filter_by_name`` returns the filter object for the specified filter. If the 
specified filter does not exist, ``filter_by_name`` returns ``null``.