Frames, Shadow DOM & Scoping

Switch To Frame

Switches the execution context into the matched iframe, so following selectors are evaluated within that frame. Call it with the iframe's own selector first, then select the elements inside it, and use InMainDom to come back out. Mandatory parameter: elementId.

WARNING

Puppeteer only. OttoMagic runs inside every frame already, so it has nothing to switch to, and Selenium does its own frame switching through the driver. The GPAL-level InFrame works on all three; only this route is engine-specific.

Examples

GPAL Fluent: High-level fluent C# API

//The browser-level call is InFrame, taking a Selector.

browser

.InFrame(iframeSelector)

.WithSelector(childSelector)

.LeftClick();

browser.InMainDom();

MagicHelper: MagicHelper utility library

//InFrame calls SwitchToElement underneath, and that is the whole implementation. OttoMagic runs a content script in every frame, so it is already inside the iframe and has nothing to switch into; scoping to the iframe element gets the same result. There is no switch-to-frame route on this layer for the same reason, which is why the REST column is empty.

browser.MagicHelper.InFrame(string elementId);

Puppeteer Client: Puppeteer-style C# client

//Puppeteer is the only engine that switches frames, because it is the only one not already running inside them.

browser.PuppeteerClient.SwitchToFrame("#iframe-selector").Execute();

Puppeteer Communicator: Low-level communicator

//Resolves the iframe element, attaches to its frame target so a cross origin frame is reachable, and gives it an isolated world. Everything after it runs inside the iframe until the context is put back.

await browser.PuppeteerCommunicator.SwitchToFrame(string frameSelector);

REST Client: Direct REST/HTTP client

//The switch-to-frame route is Puppeteer only. Over REST the equivalent is switch-to-element, scoping to the iframe element, which is what MagicHelper.InFrame sends.

browser.OttoMagicClient.SwitchToElement(string elementId).Execute();

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

Frames, Shadow DOM & Scoping

Frames, Shadow DOM & Scoping

Switch To Frame

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page