Skip to content
Get Free Trial

Multiple Domains in a Page

Web pages can contain frames and iframes loading from different domains. For example a news page from one domain may show facebook likes coming from the facebook domain. When frames or iframes in a page are loaded from a domain different from the parent page, Sahi needs to select the domain in the script to see the elements in the frame.

Sahi can target a particular domain using 2 APIs.

Since
Sahi Pro 3.5

Modes Browser

_selectDomain([$domainIdentifier])

Arguments

NameTypeDescription
$domainIdentifierstringoptionalCan be the domain name or a regular expression of it. To reference the base domain, omit this parameter or use null.

Returns

null

This function allows selecting a domain before performing further actions.

// switch to frame of domain www.domain1.com
_selectDomain("www.domain1.com");
// perform actions on frame
_assertEqual("Link Test", _getText(_link(0))); // no mention of domain needed
var $href;
_set($href, _link(0).href); // no mention of domain needed
// or
var $href="_fetch(_link(0).href);" // no mention of domain needed
...
// switch back to domain of top frame
_selectDomain();
// perform actions on domain of top frame
// To reference a domain along with its protocol, pass the protocol also. Eg.
_selectDomain("https://www.domain1.com");
Since
Sahi Pro 3.5

Modes Browser

_domain([$domainIdentifier])

Arguments

NameTypeDescription
$domainIdentifierstringoptionalCan be the domain name or a regular expression of it. To reference the base domain, omit this parameter or use null.

Returns

null

Any step to be executed on a particular domain would be prefixed by _domain("domainIdentifier").

// clicks link in frame of domain "www.domain1.com"
_domain("www.domain1.com")._click(_link(0));
// domain by regular expression
_domain("/.*domain1.*/")._click(_link(0));

To fetch a value or asserting. this needs to be used a particular way.

_domain("www.domain1.com")._assertEqual("Link Test", _getText(_link(0))); // CORRECT
_assertEqual("Link Test", _domain("www.domain1.com")._getText(_link(0))); // WRONG
var $href;
_domain("www.domain1.com")._set($href, _link(0).href); // CORRECT
_set($href, _domain("www.domain1.com")._link(0).href); // WRONG

It is better to use the _selectDomain function instead.