{"id":253,"date":"2023-07-21T08:46:00","date_gmt":"2023-07-21T15:46:00","guid":{"rendered":"https:\/\/dejal.com\/blog\/?p=253"},"modified":"2023-07-21T08:46:48","modified_gmt":"2023-07-21T15:46:48","slug":"simon-context-filter","status":"publish","type":"post","link":"https:\/\/dejal.com\/blog\/simon-context-filter\/","title":{"rendered":"Simon Context filter"},"content":{"rendered":"

<\/p>\n

The Context<\/strong> filter in Simon<\/a> is a sophisticated filter that takes the previous filter\u2019s input and match range to output some context around that filter\u2019s output text.<\/p>\n

It includes controls to specify the maximum number of characters before and\/or after the matched range, and\/or a delimiter before and\/or after the matched range. So for example you can show up to 50 characters, stopping at a line break.<\/p>\n

This filter is unusual in that it requires a previous filter to be used, and that needs to be either a Block<\/strong>\u2013 or Find<\/strong>-based filter, as those are the only ones that output the needed match range information.<\/p>\n

The Context<\/strong> filter uses the Input<\/strong> specified in the test to determine which filter\u2019s input and match variables to use: if you have two previous filters, you can make the Context<\/strong> filter look at the first one by choosing Filter1<\/strong>OutputText<\/code> instead of the default FilterOutputText<\/code> (which means the proceeding filter).<\/p>\n

The match range is available in variables used by the Context<\/strong> filter, and can be used in your custom filters or notifiers if you wish:<\/p>\n

\n{FilterMatchLocation}<\/code>: the position of the match in the input text, e.g. the text between the Block<\/strong>s, or the Find<\/strong> result. Note that the location is zero-based.<\/li>\n {FilterMatchLength}<\/code>: The length of that match.<\/li>\n

{FilterMatchEnd}<\/code>: The location plus the length, for convenience.<\/li>\n<\/ul>\nYou don\u2019t need to worry about these variables for the Context<\/strong> filter, though; it uses them internally.<\/p>\n Here\u2019s a simple example of this filter in action.<\/p>\nThis is from a Web test that looks at the Daring Fireball<\/a> site. It has a Find Required<\/strong> filter to look for the word \u201cfinally\u201d, then if that succeeds a Context<\/strong> filter to output the enclosing paragraph. To round it out, if the Find<\/strong> filter fails, the Override as Unchanged<\/strong> failure case is used, to avoid the test resulting in a failure if Gruber hasn\u2019t used the word \u201cfinally\u201d recently.<\/p>\n Below the filters, you can see the Preview<\/strong> pane\u2019s output, which you\u2019ll notice includes the word \u201cfinally\u201d towards the end.<\/p>\n <\/p>\n I hope this will be a useful filter for many of your tests. Simon is a powerful tool, with lots of other handy filters, services, and notifiers.<\/p>\n <\/p>\n<\/body>","protected":false},"excerpt":{"rendered":" The Context filter in Simon is a sophisticated filter that takes the previous filter\u2019s input and match range to output some context around that filter\u2019s output text. It includes controls to specify the maximum number of characters before and\/or after the matched range, and\/or a delimiter before and\/or after the matched range. So for example […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[16,4],"tags":[],"class_list":["post-253","post","type-post","status-publish","format-standard","hentry","category-faq","category-simon"],"jetpack_featured_media_url":"","jetpack-related-posts":[],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/posts\/253","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/comments?post=253"}],"version-history":[{"count":1,"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/posts\/253\/revisions"}],"predecessor-version":[{"id":254,"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/posts\/253\/revisions\/254"}],"wp:attachment":[{"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/media?parent=253"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/categories?post=253"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dejal.com\/blog\/wp-json\/wp\/v2\/tags?post=253"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}