KaneAI - World’s First E2E Software Testing Agent.Book a Demo Join TestMu Conference

How to use PageLocatorOptions class of Microsoft.Playwright package

Best Playwright-dotnet code snippet using Microsoft.Playwright.PageLocatorOptions

IPage.cs

Source:IPage.cs

...1100        /// A selector to use when resolving DOM element. See <a href="https://playwright.dev/dotnet/docs/selectors">working1101        /// with selectors</a> for more details.1102        /// </param>1103        /// <param name="options">Call options</param>1104        ILocator Locator(string selector, PageLocatorOptions? options = default);1105        /// <summary>1106        /// <para>1107        /// The page's main frame. Page is guaranteed to have a main frame which persists during1108        /// navigations.1109        /// </para>1110        /// </summary>1111        IFrame MainFrame { get; }1112        public IMouse Mouse { get; }1113        /// <summary>1114        /// <para>1115        /// Returns the opener for popup pages and <c>null</c> for others. If the opener has1116        /// been closed already the returns <c>null</c>.1117        /// </para>1118        /// </summary>...

Page.cs

Source:Page.cs

...364        public Task<T> EvaluateAsync<T>(string expression, object arg) => MainFrame.EvaluateAsync<T>(expression, arg);365        public Task<JsonElement?> EvalOnSelectorAsync(string selector, string expression, object arg) => MainFrame.EvalOnSelectorAsync(selector, expression, arg);366        public Task<T> EvalOnSelectorAsync<T>(string selector, string expression, object arg = null, PageEvalOnSelectorOptions options = null)367            => MainFrame.EvalOnSelectorAsync<T>(selector, expression, arg, new() { Strict = options?.Strict });368        public ILocator Locator(string selector, PageLocatorOptions options = default)369            => MainFrame.Locator(selector, new() { HasTextString = options?.HasTextString, HasTextRegex = options?.HasTextRegex, Has = options?.Has });370        public Task<IElementHandle> QuerySelectorAsync(string selector, PageQuerySelectorOptions options = null)371            => MainFrame.QuerySelectorAsync(selector, new() { Strict = options?.Strict });372        public Task<T> EvalOnSelectorAsync<T>(string selector, string expression, object arg) => MainFrame.EvalOnSelectorAsync<T>(selector, expression, arg);373        public Task<JsonElement?> EvalOnSelectorAllAsync(string selector, string expression, object arg) => MainFrame.EvalOnSelectorAllAsync(selector, expression, arg);374        public Task<T> EvalOnSelectorAllAsync<T>(string selector, string expression, object arg) => MainFrame.EvalOnSelectorAllAsync<T>(selector, expression, arg);375        public Task FillAsync(string selector, string value, PageFillOptions options = default)376            => MainFrame.FillAsync(selector, value, new() { NoWaitAfter = options?.NoWaitAfter, Timeout = options?.Timeout, Force = options?.Force, Strict = options?.Strict });377        public Task SetInputFilesAsync(string selector, string files, PageSetInputFilesOptions options = default)378            => MainFrame.SetInputFilesAsync(selector, files, Map(options));379        public Task SetInputFilesAsync(string selector, IEnumerable<string> files, PageSetInputFilesOptions options = default)380            => MainFrame.SetInputFilesAsync(selector, files, Map(options));381        public Task SetInputFilesAsync(string selector, FilePayload files, PageSetInputFilesOptions options = default)382            => MainFrame.SetInputFilesAsync(selector, files, Map(options));...

PlaywrightSyncElement.cs

Source:PlaywrightSyncElement.cs

...19        /// </summary>20        /// <param name="page">The assoicated playwright page</param>21        /// <param name="selector">Element selector</param>22        /// <param name="options">Advanced locator options</param>23        public PlaywrightSyncElement(IPage page, string selector, PageLocatorOptions? options = null)24        {25            this.ParentPage = page;26            this.Selector = selector;27            this.PageOptions = options;28        }29        /// <summary>30        /// Initializes a new instance of the <see cref="PlaywrightSyncElement" /> class31        /// </summary>32        /// <param name="parent">The parent playwright element</param>33        /// <param name="selector">Sub element selector</param>34        /// <param name="options">Advanced locator options</param>35        public PlaywrightSyncElement(PlaywrightSyncElement parent, string selector, LocatorLocatorOptions? options = null)36        {37            this.ParentLocator = parent.ElementLocator();38            this.Selector = selector;39            this.LocatorOptions = options;40        }41        /// <summary>42        /// Initializes a new instance of the <see cref="PlaywrightSyncElement" /> class43        /// </summary>44        /// <param name="frame">The assoicated playwright frame locator</param>45        /// <param name="selector">Element selector</param>46        public PlaywrightSyncElement(IFrameLocator frame, string selector)47        {48            this.ParentFrameLocator = frame;49            this.Selector = selector;50        }51        /// <summary>52        /// Initializes a new instance of the <see cref="PlaywrightSyncElement" /> class53        /// </summary>54        /// <param name="testObject">The assoicated playwright test object</param>55        /// <param name="selector">Element selector</param>56        /// <param name="options">Advanced locator options</param>57        public PlaywrightSyncElement(IPlaywrightTestObject testObject, string selector, PageLocatorOptions? options = null) : this(testObject.PageDriver.AsyncPage, selector, options)58        {59        }60        /// <summary>61        /// Initializes a new instance of the <see cref="PlaywrightSyncElement" /> class62        /// </summary>63        /// <param name="driver">The assoicated playwright page driver</param>64        /// <param name="selector">Element selector</param>65        /// <param name="options">Advanced locator options</param>66        public PlaywrightSyncElement(PageDriver driver, string selector, PageLocatorOptions? options = null) : this(driver.AsyncPage, selector, options)67        {68        }69        /// <summary>70        /// Gets the parent async page71        /// </summary>72        public IPage? ParentPage { get; private set; }73        /// <summary>74        /// Gets the parent locator75        /// </summary>76        public ILocator? ParentLocator { get; private set; }77        /// <summary>78        /// Gets the parent frame locator79        /// </summary>80        public IFrameLocator? ParentFrameLocator { get; private set; }81        /// <summary>82        /// Gets the page locator options83        /// </summary>84        public PageLocatorOptions? PageOptions { get; private set; }85        /// <summary>86        /// Gets the page locator options87        /// </summary>88        public LocatorLocatorOptions? LocatorOptions { get; private set; }89        /// <summary>90        /// Gets the selector string91        /// </summary>92        public string Selector { get; private set; }93        /// <summary>94        /// ILocator for this element95        /// </summary>96        /// <returns></returns>97        public ILocator ElementLocator()98        {...

FunctionalUITest.cs

Source:FunctionalUITest.cs

...110            // NOTE: I'd prefer to use btn-admin. However, I want this test to work against the current111            // deployment, without having to deploy again.112            // TODO: Change to use data-test-id in the future after 1.0.0-rc is finalized113            // var btn_admin = Page.Locator("data-test-id=btn-admin");114            var link_getstarted = Page.Locator("a", new PageLocatorOptions() { HasTextString = "Get Started" });115            if (await link_getstarted.IsVisibleAsync())116            {117                // We only need to seed if this link is going to the Admin page118                var href = await link_getstarted.GetAttributeAsync("href");119                if (href == "/Admin")120                {121                    // So let's click through to the admin page and add some data!122                    await link_getstarted.ClickAsync();123                    await Page.SaveScreenshotToAsync(TestContext,"Admin page");124                    await Page.ClickAsync($"div[data-id=all]");125                    await Task.Delay(500);126                    await Page.SaveScreenshotToAsync(TestContext,"Seeding database");127                    await Page.ClickAsync("text=Close");128                    await Page.SaveScreenshotToAsync(TestContext,"Seeding complete");...

PlaywrightSyncElementTests.cs

Source:PlaywrightSyncElementTests.cs

...129        /// <summary>130        /// Test page locator options work as expected131        /// </summary>132        [TestMethod]133        public void PageLocatorOptionsTest()134        {135            PageLocatorOptions locator = new PageLocatorOptions136            {137                HasTextString = "Elements",138            };139            var element = new PlaywrightSyncElement(this.TestObject, Models[this.TestObject].MainHeader.Selector, locator);140            Assert.IsTrue(element.IsVisible());141        }142        /// <summary>143        /// Test fill works as expected144        /// </summary>145        [TestMethod]146        public void FillTest()147        {148            Models[this.TestObject].FirstNameText.Fill("Ted");149            Assert.AreEqual("Ted", Models[this.TestObject].FirstNameText.InputValue());...

PageLocatorOptions.cs

Source:PageLocatorOptions.cs

...35using System.Threading.Tasks;36#nullable enable37namespace Microsoft.Playwright38{39    public class PageLocatorOptions40    {41        public PageLocatorOptions() { }42        public PageLocatorOptions(PageLocatorOptions clone)43        {44            if (clone == null)45            {46                return;47            }48            Has = clone.Has;49            HasTextString = clone.HasTextString;50            HasTextRegex = clone.HasTextRegex;51        }52        /// <summary>53        /// <para>54        /// Matches elements containing an element that matches an inner locator. Inner locator55        /// is queried against the outer one. For example, <c>article</c> that has <c>text=Playwright</c>56        /// matches <c>&lt;article&gt;&lt;div&gt;Playwright&lt;/div&gt;&lt;/article&gt;</c>....

PageLocatorOptions

Using AI Code Generation

1using Microsoft.Playwright;2using System;3using System.Threading.Tasks;4{5    {6        static async Task Main(string[] args)7        {8            using var playwright = await Playwright.CreateAsync();9            var browser = await playwright.Chromium.LaunchAsync(new LaunchOptions10            {11            });12            var context = await browser.NewContextAsync(new BrowserNewContextOptions13            {14                Permissions = new[] { "geolocation" },15                Geolocation = new Geolocation { Longitude = 12.492507, Latitude = 41.889938 },16                UserAgent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36",17                ExtraHttpHeaders = new Dictionary<string, string> { { "foo", "bar" } }18            });19            var page = await context.NewPageAsync(new PageLocatorOptions20            {21            });22            await page.WaitForLoadStateAsync(LoadState.DOMContentLoaded);23            await page.WaitForTimeoutAsync(10000);24            await page.CloseAsync();25            await context.CloseAsync();26            await browser.CloseAsync();27        }28    }29}

PageLocatorOptions

Using AI Code Generation

1using Microsoft.Playwright;2using System;3using System.Threading.Tasks;4{5    {6        static async Task Main(string[] args)7        {8            using var playwright = await Playwright.CreateAsync();9            await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions10            {11            });12            var context = await browser.NewContextAsync(new BrowserNewContextOptions13            {14                {15                },16                Permissions = new[] { "geolocation" },17            });18            var page = await context.NewPageAsync(new PageLocatorOptions19            {20            });21            await page.ClickAsync("text=Search");22            await page.TypeAsync("text=Search", "Piazza Navona");23            await page.PressAsync("text=Search", "Enter");

PageLocatorOptions

Using AI Code Generation

1using Microsoft.Playwright;2using System;3using System.Threading.Tasks;4{5    {6        static async Task Main(string[] args)7        {8            using var playwright = await Playwright.CreateAsync();9            await using var browser = await playwright.Chromium.LaunchAsync(new LaunchOptions { Headless = false });10            var page = await browser.NewPageAsync(new BrowserNewPageOptions { WaitForLoadState = WaitForLoadState.Networkidle });11            await page.ScreenshotAsync("example.png");12        }13    }14}15using Microsoft.Playwright;16using System;17using System.Threading.Tasks;18{19    {20        static async Task Main(string[] args)21        {22            using var playwright = await Playwright.CreateAsync();23            await using var browser = await playwright.Chromium.LaunchAsync(new LaunchOptions { Headless = false });24            var context = await browser.NewContextAsync(new BrowserContextOptions { RecordVideo = new BrowserContextVideoOptions { Dir = "videos" } });25            var page = await context.NewPageAsync();26            await page.ScreenshotAsync("example.png");27        }

PageLocatorOptions

Using AI Code Generation

1var playwright = await Playwright.CreateAsync();2var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions3{4});5var context = await browser.NewContextAsync(new BrowserNewContextOptions6{7    {8    },9    {10    }11});12var page = await context.NewPageAsync();13await page.ClickAsync("text=Images");14await page.ClickAsync("text=Videos");15await page.ClickAsync("text=Shopping");16await page.ClickAsync("text=News");17await page.ClickAsync("text=Maps");18await page.ClickAsync("text=Books");19await page.ClickAsync("text=Flights");20await page.ClickAsync("text=Apps");21await page.ClickAsync("text=More");22await page.ClickAsync("text=Settings");23await page.ClickAsync("text=Tools");24await page.ClickAsync("text=Sign in");25await page.ClickAsync("text=Privacy");26await page.ClickAsync("text=Terms");27await page.ClickAsync("text=Advertising");28await page.ClickAsync("text=Business");29await page.ClickAsync("text=About");30await page.ClickAsync("text=How Search works");31await page.ClickAsync("text=Privacy");32await page.ClickAsync("text=Terms");33await page.ClickAsync("text=Settings");34await page.ClickAsync("text=Advertising");35await page.ClickAsync("text=Business");36await page.ClickAsync("text=About");37await page.ClickAsync("text=How Search works");38await page.ClickAsync("text=Privacy");39await page.ClickAsync("text=Terms");40await page.ClickAsync("text=Settings");41await page.ClickAsync("text=Advertising");42await page.ClickAsync("text=Business");43await page.ClickAsync("text=About");44await page.ClickAsync("text=How Search works");45await page.ClickAsync("text=Privacy");46await page.ClickAsync("text=Terms");47await page.ClickAsync("text=Settings");48await page.ClickAsync("text=Advertising");49await page.ClickAsync("text=Business");50await page.ClickAsync("text=About");51await page.ClickAsync("text=How Search works");52await page.ClickAsync("text=Privacy");

PageLocatorOptions

Using AI Code Generation

1using Microsoft.Playwright;2using Microsoft.Playwright.NUnit;3using NUnit.Framework;4using System;5using System.Collections.Generic;6using System.Linq;7using System.Text;8using System.Threading.Tasks;9{10    {11        public async Task Test1()12        {13            using var playwright = await Playwright.CreateAsync();14            await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions { Headless = false });15            var page = await browser.NewPageAsync();16            await page.ClickAsync("input[title='Search']");17            await page.TypeAsync("input[title='Search']", "Hello World");18            await page.Keyboard.PressAsync("Enter");19            await page.WaitForLoadStateAsync(LoadState.DOMContentLoaded);20            await page.ScreenshotAsync("example.png");21        }22    }23}24using Microsoft.Playwright;25using Microsoft.Playwright.NUnit;26using NUnit.Framework;27using System;28using System.Collections.Generic;29using System.Linq;30using System.Text;31using System.Threading.Tasks;32{33    {34        public async Task Test1()35        {36            using var playwright = await Playwright.CreateAsync();37            await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions { Headless = false });38            var page = await browser.NewPageAsync();39            await page.ClickAsync("input[title='Search']");40            await page.TypeAsync("input[title='Search']", "Hello World");41            await page.Keyboard.PressAsync("Enter");42            await page.WaitForLoadStateAsync(LoadState.DOMContentLoaded);43            await page.ScreenshotAsync("example.png");44        }45    }

PageLocatorOptions

Using AI Code Generation

1await page.Locator("button").ClickAsync();2await page.Locator("button").ClickAsync(new PageLocatorOptions { Force = true });3await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 }, Force = true });4await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 } });5await page.Locator("button").ClickAsync();6await page.Locator("button").ClickAsync(new PageLocatorOptions { Force = true });7await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 }, Force = true });8await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 } });9await page.Locator("button").ClickAsync();10await page.Locator("button").ClickAsync(new PageLocatorOptions { Force = true });11await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 }, Force = true });12await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 } });13await page.Locator("button").ClickAsync();14await page.Locator("button").ClickAsync(new PageLocatorOptions { Force = true });15await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 }, Force = true });16await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X = 2, Y = 2 } });17await page.Locator("button").ClickAsync();18await page.Locator("button").ClickAsync(new PageLocatorOptions { Force = true });19await page.Locator("button").ClickAsync(new PageLocatorOptions { Position = new Position { X =

PageLocatorOptions

Using AI Code Generation

1using Microsoft.Playwright;2using System;3using System.Threading.Tasks;4{5    {6        static async Task Main(string[] args)7        {8            using var playwright = await Playwright.CreateAsync();9            await using var browser = await playwright.Chromium.LaunchAsync(new LaunchOptions10            {11            });12            var page = await browser.NewPageAsync();

PageLocatorOptions

Using AI Code Generation

1using Microsoft.Playwright;2using System;3using System.Collections.Generic;4using System.Linq;5using System.Text;6using System.Threading.Tasks;7{8    {9        static async Task Main(string[] args)10        {11            using var playwright = await Playwright.CreateAsync();12            await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions13            {14            });15            var context = await browser.NewContextAsync(new BrowserNewContextOptions16            {17            });18            var page = await context.NewPageAsync();19            await page.ClickAsync("input[id='search']");20            await page.TypeAsync("input[id='search']", "C#");21            await page.ClickAsync("button#search-icon-legacy");22            await page.ClickAsync("a#video-title[href='/watch?v=4e4jK8Z4J4w']");23            await page.ClickAsync("ytd-toggle-button-renderer#top-level-buttons > a#button");24            await page.WaitForTimeoutAsync(5000);25            await page.ClickAsync("ytd-toggle-button-renderer#top-level-buttons > a#button");26            await page.ClickAsync("ytd-toggle-button-renderer#top-level-buttons > a#button");27            await page.WaitForTimeoutAsync(5000);28            await page.ClickAsync("ytd-toggle-button-renderer#top-level-buttons > a#button");29            await page.ClickAsync("ytd-toggle-button-renderer#top-level-buttons > a#button");30            await page.WaitForTimeoutAsync(5000);31            await page.ClickAsync("ytd-toggle-button-renderer#top-level-buttons > a#button");

PageLocatorOptions

Using AI Code Generation

1{2};3await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions4{5});6await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions7{8});9await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions10{11});12await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions13{14});15await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions16{17});18await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions19{20});21await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions22{23});24await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions25{26});27await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions28{29});30await page.WaitForSelectorAsync("table", new PageWaitForSelectorOptions31{

Playwright tutorial

LambdaTest’s Playwright tutorial will give you a broader idea about the Playwright automation framework, its unique features, and use cases with examples to exceed your understanding of Playwright testing. This tutorial will give A to Z guidance, from installing the Playwright framework to some best practices and advanced concepts.

Chapters:

What is Playwright : Playwright is comparatively new but has gained good popularity. Get to know some history of the Playwright with some interesting facts connected with it.
How To Install Playwright : Learn in detail about what basic configuration and dependencies are required for installing Playwright and run a test. Get a step-by-step direction for installing the Playwright automation framework.
Playwright Futuristic Features: Launched in 2020, Playwright gained huge popularity quickly because of some obliging features such as Playwright Test Generator and Inspector, Playwright Reporter, Playwright auto-waiting mechanism and etc. Read up on those features to master Playwright testing.
What is Component Testing: Component testing in Playwright is a unique feature that allows a tester to test a single component of a web application without integrating them with other elements. Learn how to perform Component testing on the Playwright automation framework.
Inputs And Buttons In Playwright: Every website has Input boxes and buttons; learn about testing inputs and buttons with different scenarios and examples.
Functions and Selectors in Playwright: Learn how to launch the Chromium browser with Playwright. Also, gain a better understanding of some important functions like “BrowserContext,” which allows you to run multiple browser sessions, and “newPage” which interacts with a page.
Handling Alerts and Dropdowns in Playwright : Playwright interact with different types of alerts and pop-ups, such as simple, confirmation, and prompt, and different types of dropdowns, such as single selector and multi-selector get your hands-on with handling alerts and dropdown in Playright testing.
Playwright vs Puppeteer: Get to know about the difference between two testing frameworks and how they are different than one another, which browsers they support, and what features they provide.
Run Playwright Tests on LambdaTest: Playwright testing with LambdaTest leverages test performance to the utmost. You can run multiple Playwright tests in Parallel with the LammbdaTest test cloud. Get a step-by-step guide to run your Playwright test on the LambdaTest platform.
Playwright Python Tutorial: Playwright automation framework support all major languages such as Python, JavaScript, TypeScript, .NET and etc. However, there are various advantages to Python end-to-end testing with Playwright because of its versatile utility. Get the hang of Playwright python testing with this chapter.
Playwright End To End Testing Tutorial: Get your hands on with Playwright end-to-end testing and learn to use some exciting features such as TraceViewer, Debugging, Networking, Component testing, Visual testing, and many more.
Playwright Video Tutorial: Watch the video tutorials on Playwright testing from experts and get a consecutive in-depth explanation of Playwright automation testing.