Network & File Transfers

Left Click And Download

Performs a left click on the matched element and captures the file that downloads as a result, saving it to the specified location.

NOTE

A browser sometimes asks where to save even with prompting turned off. GPAL waits briefly for that, and answers it with the same full pathname rather than letting the workflow stall on a window nobody expected, publishing a WARNING that it did. The dialog is titled Save As on Chrome and Edge, and Enter name of file to save to on Firefox, which is why a browser GPAL does not recognise cannot be answered.

Examples

GPAL Fluent: High-level fluent C# API

//The GPALFile is where the file is to end up, and how it gets there depends on whether a Save As dialog is coming. With prompting off, or headless, no dialog appears: GPAL sets the download location, clicks, and watches the directory for the file to land. With prompting on, the dialog is expected, and GPAL waits for it and types the full pathname into it before pressing Enter. So this is not the same as SetDownloadFilename, which only names a file in the browser's own download directory.

browser.WithSelector(linkSelector).LeftClickAndDownload(gpalFile);

MagicHelper: MagicHelper utility library

browser.MagicHelper.LeftClickAndDownload("link123", filenameAndPath);

Puppeteer Client: Puppeteer-style C# client

//The PuppeteerClient call that names the destination is DownloadTo. It was SaveTo until August 2026.

browser.PuppeteerClient.LeftClickAndDownload(linkSelector).DownloadTo(fileToSave).Execute();

Puppeteer Communicator: Low-level communicator

await browser.PuppeteerCommunicator.LeftClickAndDownload(elems, savePath, modifiers, sessionId, responses);

REST Client: Direct REST/HTTP client

browser.OttoMagicClient.WithEndpoint(ApiEndpoint.LeftClickAndDownload).WithElementId(linkSelector).WithDownloadFile(savePath).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();

Network & File Transfers

Network & File Transfers

Left Click And Download

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page