Test Info > Filters

The Filters page of the Test Info pane includes the ability to analyze the text output from the service.

A filter is a particular configuration of a filter plug-in. A filter plug-in does the actual work of analyzing the text. There can be multiple filters based on the same filter plug-in, e.g. the Find Keyword, Find Regular Expression, HTML Body, and List Hyperlinks filters are all variations of the Find Filter Plug-in, each looking for different text and other properties.

You can detect if the text changed from the previous time it was checked, and perform all sorts of operations on the output text and status, e.g. to narrow the text down to an interesting portion or to avoid dynamic content (like banner ads). You can result in a failure if some required text isn't found, or if some unwanted text is found. You can also cancel out a failure or otherwise change the status, if desired. And lots more.

New Filter: Click this button to display the Filter Info pane, allowing a new filter to be added.

From the pop-up menu on the left of each line, choose Any to use this filter with any current test status, Success to use it when not a failure, or Unchanged, Changed or Failure to only use it with that specific status. If the status of the service or previous filter matches the selected one, this filter is used, otherwise it's skipped. Choose None to temporarily disable this line (its filter will be remembered), or click the - button to remove the line.

The next pop-up menu lists all of the available filters for the specified status. You can click the New Filter button to add a new one, if required.

Input: This pop-up menu specifies what text to pass to the filter as its input. The filter typically performs its magic on this text, though some filters could ignore it or use different text, by using Filter Variables. The menu lists the various outputs of the service, plus (if there are any previous filters listed) the outputs of those filters.

- Click this button to remove the associated line.

+ Click this button to add a new line, allowing another filter to be specified.

You can add your own filters, or modify these, via the Filters list.

The default filters fall into the following categories (based on the plug-ins that implement them). Click each to read more about them:

By default, Simon includes the Change filter, so any difference in the input will result in a change. You can change it to a Block filter or some other kind to limit the range of text examined, or disable it if you don't want to detect changes.

Related Topics