« Documentation Home

RuleOptions.thirdParty

This documentation relates to Opera's now deprecated .oex Extension API framework for Opera versions <= 12.15 and also provided by our OEX2NEX shim library.

For the latest Opera Extensions API documentation for Opera versions > 12.15 please consult the latest Opera Extensions API documentation online.

Description:

A boolean property specifying whether a given URL Filter rule should apply to third-party domains. The value true indicates that only domains with a different origin are matched by this option. The value false indicates that only domains with the same origin are matched by this option. The value null, or if the thirdParty property is not specified, indicates that all domains are matched by this option.

This property is passed within a RuleOptions object as a parameter for URL Filter methods.

Syntax:

boolean thirdParty

Example:

The following example blocks any content from the facebook.com domain, but only when it's included in a web page as third-party code, i.e. in non-facebook.com domains.

<!-- 
  The configuration file ('config.xml').
-->
<?xml version='1.0' encoding='utf-8'?>
<widget xmlns="http://www.w3.org/ns/widgets">
    ...
    <feature name="opera:urlfilter"/>
</widget>

//
// The background process (e.g. index.html)
//

// Check that the URL Filter API exists
if (typeof opera.extension.urlfilter != 'undefined') {
  // Set the options for the filter rule
  var ruleOptions = {
    thirdParty: true
  }
  
  opera.extension.urlfilter.block.add('||facebook.com/*', ruleOptions);
}

Note the use of || which is a hostname mark. This indicates that the subsequent characters should begin matching from any host name in the URL. For example, ||example.com* matches http://example.com/, https://www.example.com/, or similar. However, it will not match http://badexample.com/.