KaneAI - World’s First E2E Software Testing Agent.Book a Demo 
How to use LocatorElementHandleOptions method of Microsoft.Playwright.LocatorElementHandleOptions class
Best Playwright-dotnet code snippet using Microsoft.Playwright.LocatorElementHandleOptions.LocatorElementHandleOptions
ILocator.cs
Source:ILocator.cs 
...224 /// match the selector, throws.225 /// </para>226 /// </summary>227 /// <param name="options">Call options</param>228 Task<IElementHandle> ElementHandleAsync(LocatorElementHandleOptions? options = default);229 /// <summary><para>Resolves given locator to all matching DOM elements.</para></summary>230 Task<IReadOnlyList<IElementHandle>> ElementHandlesAsync();231 /// <summary>232 /// <para>Returns the return value of <paramref name="expression"/>.</para>233 /// <para>This method passes this handle as the first argument to <paramref name="expression"/>.</para>234 /// <para>235 /// If <paramref name="expression"/> returns a <see cref="Task"/>, then <c>handle.evaluate</c>236 /// would wait for the promise to resolve and return its value.237 /// </para>238 /// <para>Examples:</para>239 /// <code>240 /// var tweets = page.Locator(".tweet .retweets");<br/>241 /// Assert.AreEqual("10 retweets", await tweets.EvaluateAsync("node => node.innerText"));242 /// </code>...
LocatorSynchronous.cs
Source:LocatorSynchronous.cs
...919 /// match the selector, throws.920 /// </para>921 /// </summary>922 /// <param name="options">Call options</param>923 public static IElementHandle ElementHandle(this ILocator locator, LocatorElementHandleOptions? options = null)924 {925 return locator.ElementHandleAsync(options).GetAwaiter().GetResult();926 }927 /// <summary><para>Resolves given locator to all matching DOM elements.</para></summary>928 public static IReadOnlyList<IElementHandle> ElementHandles(this ILocator locator)929 {930 return locator.ElementHandlesAsync().GetAwaiter().GetResult();931 }932 public static JsonElement? Evaluate(this ILocator locator, string expression, object? arg = null, LocatorEvaluateOptions? options = null)933 {934 return locator.EvaluateAsync(expression, arg, options).GetAwaiter().GetResult();935 }936 /// <summary>937 /// <para>Returns the return value of <paramref name="expression"/>.</para>...
Locator.cs
Source:Locator.cs
...103 public Task DispatchEventAsync(string type, object eventInit = null, LocatorDispatchEventOptions options = null)104 => _frame.DispatchEventAsync(_selector, type, eventInit, ConvertOptions<FrameDispatchEventOptions>(options));105 public Task DragToAsync(ILocator target, LocatorDragToOptions options = null)106 => _frame.DragAndDropAsync(_selector, ((Locator)target)._selector, ConvertOptions<FrameDragAndDropOptions>(options));107 public async Task<IElementHandle> ElementHandleAsync(LocatorElementHandleOptions options = null)108 => await _frame.WaitForSelectorAsync(109 _selector,110 ConvertOptions<FrameWaitForSelectorOptions>(options)).ConfigureAwait(false);111 public Task<IReadOnlyList<IElementHandle>> ElementHandlesAsync()112 => _frame.QuerySelectorAllAsync(_selector);113 public Task<T> EvaluateAllAsync<T>(string expression, object arg = null)114 => _frame.EvalOnSelectorAllAsync<T>(_selector, expression, arg);115 public Task<JsonElement?> EvaluateAsync(string expression, object arg = null, LocatorEvaluateOptions options = null)116 => EvaluateAsync<JsonElement?>(expression, arg, options);117 public Task<T> EvaluateAsync<T>(string expression, object arg = null, LocatorEvaluateOptions options = null)118 => _frame.EvalOnSelectorAsync<T>(_selector, expression, arg, ConvertOptions<FrameEvalOnSelectorOptions>(options));119 public async Task<IJSHandle> EvaluateHandleAsync(string expression, object arg = null, LocatorEvaluateHandleOptions options = null)120 => await WithElementAsync(async (e, _) => await e.EvaluateHandleAsync(expression, arg).ConfigureAwait(false), options).ConfigureAwait(false);121 public async Task FillAsync(string value, LocatorFillOptions options = null)122 => await _frame.FillAsync(_selector, value, ConvertOptions<FrameFillOptions>(options)).ConfigureAwait(false);123 public Task FocusAsync(LocatorFocusOptions options = null)124 => _frame.FocusAsync(_selector, ConvertOptions<FrameFocusOptions>(options));125 IFrameLocator ILocator.FrameLocator(string selector) =>126 new FrameLocator(_frame, $"{_selector} >> {selector}");127 public Task<string> GetAttributeAsync(string name, LocatorGetAttributeOptions options = null)128 => _frame.GetAttributeAsync(_selector, name, ConvertOptions<FrameGetAttributeOptions>(options));129 public Task HoverAsync(LocatorHoverOptions options = null)130 => _frame.HoverAsync(_selector, ConvertOptions<FrameHoverOptions>(options));131 public Task<string> InnerHTMLAsync(LocatorInnerHTMLOptions options = null)132 => _frame.InnerHTMLAsync(_selector, ConvertOptions<FrameInnerHTMLOptions>(options));133 public Task<string> InnerTextAsync(LocatorInnerTextOptions options = null)134 => _frame.InnerTextAsync(_selector, ConvertOptions<FrameInnerTextOptions>(options));135 public Task<string> InputValueAsync(LocatorInputValueOptions options = null)136 => _frame.InputValueAsync(_selector, ConvertOptions<FrameInputValueOptions>(options));137 public Task<bool> IsCheckedAsync(LocatorIsCheckedOptions options = null)138 => _frame.IsCheckedAsync(_selector, ConvertOptions<FrameIsCheckedOptions>(options));139 public Task<bool> IsDisabledAsync(LocatorIsDisabledOptions options = null)140 => _frame.IsDisabledAsync(_selector, ConvertOptions<FrameIsDisabledOptions>(options));141 public Task<bool> IsEditableAsync(LocatorIsEditableOptions options = null)142 => _frame.IsEditableAsync(_selector, ConvertOptions<FrameIsEditableOptions>(options));143 public Task<bool> IsEnabledAsync(LocatorIsEnabledOptions options = null)144 => _frame.IsEnabledAsync(_selector, ConvertOptions<FrameIsEnabledOptions>(options));145 public Task<bool> IsHiddenAsync(LocatorIsHiddenOptions options = null)146 => _frame.IsHiddenAsync(_selector, ConvertOptions<FrameIsHiddenOptions>(options));147 public Task<bool> IsVisibleAsync(LocatorIsVisibleOptions options = null)148 => _frame.IsVisibleAsync(_selector, ConvertOptions<FrameIsVisibleOptions>(options));149 public ILocator Nth(int index)150 => new Locator(_frame, $"{_selector} >> nth={index}");151 public Task PressAsync(string key, LocatorPressOptions options = null)152 => _frame.PressAsync(_selector, key, ConvertOptions<FramePressOptions>(options));153 public Task<byte[]> ScreenshotAsync(LocatorScreenshotOptions options = null)154 => WithElementAsync(async (h, o) => await h.ScreenshotAsync(ConvertOptions<ElementHandleScreenshotOptions>(o)).ConfigureAwait(false), options);155 public Task ScrollIntoViewIfNeededAsync(LocatorScrollIntoViewIfNeededOptions options = null)156 => WithElementAsync(async (h, o) => await h.ScrollIntoViewIfNeededAsync(ConvertOptions<ElementHandleScrollIntoViewIfNeededOptions>(o)).ConfigureAwait(false), options);157 public Task<IReadOnlyList<string>> SelectOptionAsync(string values, LocatorSelectOptionOptions options = null)158 => _frame.SelectOptionAsync(_selector, values, ConvertOptions<FrameSelectOptionOptions>(options));159 public Task<IReadOnlyList<string>> SelectOptionAsync(IElementHandle values, LocatorSelectOptionOptions options = null)160 => _frame.SelectOptionAsync(_selector, values, ConvertOptions<FrameSelectOptionOptions>(options));161 public Task<IReadOnlyList<string>> SelectOptionAsync(IEnumerable<string> values, LocatorSelectOptionOptions options = null)162 => _frame.SelectOptionAsync(_selector, values, ConvertOptions<FrameSelectOptionOptions>(options));163 public Task<IReadOnlyList<string>> SelectOptionAsync(SelectOptionValue values, LocatorSelectOptionOptions options = null)164 => _frame.SelectOptionAsync(_selector, values, ConvertOptions<FrameSelectOptionOptions>(options));165 public Task<IReadOnlyList<string>> SelectOptionAsync(IEnumerable<IElementHandle> values, LocatorSelectOptionOptions options = null)166 => _frame.SelectOptionAsync(_selector, values, ConvertOptions<FrameSelectOptionOptions>(options));167 public Task<IReadOnlyList<string>> SelectOptionAsync(IEnumerable<SelectOptionValue> values, LocatorSelectOptionOptions options = null)168 => _frame.SelectOptionAsync(_selector, values, ConvertOptions<FrameSelectOptionOptions>(options));169 public Task SelectTextAsync(LocatorSelectTextOptions options = null)170 => WithElementAsync((h, o) => h.SelectTextAsync(ConvertOptions<ElementHandleSelectTextOptions>(o)), options);171 public Task SetInputFilesAsync(string files, LocatorSetInputFilesOptions options = null)172 => _frame.SetInputFilesAsync(_selector, files, ConvertOptions<FrameSetInputFilesOptions>(options));173 public Task SetInputFilesAsync(IEnumerable<string> files, LocatorSetInputFilesOptions options = null)174 => _frame.SetInputFilesAsync(_selector, files, ConvertOptions<FrameSetInputFilesOptions>(options));175 public Task SetInputFilesAsync(FilePayload files, LocatorSetInputFilesOptions options = null)176 => _frame.SetInputFilesAsync(_selector, files, ConvertOptions<FrameSetInputFilesOptions>(options));177 public Task SetInputFilesAsync(IEnumerable<FilePayload> files, LocatorSetInputFilesOptions options = null)178 => _frame.SetInputFilesAsync(_selector, files, ConvertOptions<FrameSetInputFilesOptions>(options));179 public Task TapAsync(LocatorTapOptions options = null)180 => _frame.TapAsync(_selector, ConvertOptions<FrameTapOptions>(options));181 public Task<string> TextContentAsync(LocatorTextContentOptions options = null)182 => _frame.TextContentAsync(_selector, ConvertOptions<FrameTextContentOptions>(options));183 public Task TypeAsync(string text, LocatorTypeOptions options = null)184 => _frame.TypeAsync(_selector, text, ConvertOptions<FrameTypeOptions>(options));185 public Task UncheckAsync(LocatorUncheckOptions options = null)186 => _frame.UncheckAsync(_selector, ConvertOptions<FrameUncheckOptions>(options));187 ILocator ILocator.Locator(string selector, LocatorLocatorOptions options)188 => new Locator(_frame, $"{_selector} >> {selector}", options);189 public Task WaitForAsync(LocatorWaitForOptions options = null)190 => _frame.LocatorWaitForAsync(_selector, ConvertOptions<LocatorWaitForOptions>(options));191 internal Task<FrameExpectResult> ExpectAsync(string expression, FrameExpectOptions options = null)192 => _frame.ExpectAsync(193 _selector,194 expression,195 options);196 public override string ToString() => "Locator@" + _selector;197 private T ConvertOptions<T>(object source)198 where T : class, new()199 {200 T target = new();201 var targetType = target.GetType();202 if (source != null)203 {204 var sourceType = source.GetType();205 foreach (var sourceProperty in sourceType.GetProperties())206 {207 var targetProperty = targetType.GetProperty(sourceProperty.Name);208 if (targetProperty != null)209 {210 targetProperty.SetValue(target, sourceProperty.GetValue(source));211 }212 }213 }214 var strictProperty = targetType.GetProperty("Strict");215 if (strictProperty != null && strictProperty.GetValue(target) == null)216 {217 strictProperty.SetValue(target, true);218 }219 return target;220 }221 private async Task<TResult> WithElementAsync<TOptions, TResult>(Func<IElementHandle, TOptions, Task<TResult>> callback, TOptions options)222 where TOptions : class223 where TResult : class224 {225 IElementHandle handle = await ElementHandleAsync(ConvertOptions<LocatorElementHandleOptions>(options)).ConfigureAwait(false);226 try227 {228 return await callback(handle, options).ConfigureAwait(false);229 }230 finally231 {232 await handle.DisposeAsync().ConfigureAwait(false);233 }234 }235 private async Task WithElementAsync<TOptions>(Func<IElementHandle, TOptions, Task> callback, TOptions options)236 where TOptions : class237 {238 IElementHandle handle = await ElementHandleAsync(ConvertOptions<LocatorElementHandleOptions>(options)).ConfigureAwait(false);239 try240 {241 await callback(handle, options).ConfigureAwait(false);242 }243 finally244 {245 await handle.DisposeAsync().ConfigureAwait(false);246 }247 }248 public Task HighlightAsync() => _frame.HighlightAsync(_selector);249 }250}...
LocatorElementHandleOptions.cs
Source:LocatorElementHandleOptions.cs
...35using System.Threading.Tasks;36#nullable enable37namespace Microsoft.Playwright38{39 public class LocatorElementHandleOptions40 {41 public LocatorElementHandleOptions() { }42 public LocatorElementHandleOptions(LocatorElementHandleOptions clone)43 {44 if (clone == null)45 {46 return;47 }48 Timeout = clone.Timeout;49 }50 /// <summary>51 /// <para>52 /// Maximum time in milliseconds, defaults to 30 seconds, pass <c>0</c> to disable timeout.53 /// The default value can be changed by using the <see cref="IBrowserContext.SetDefaultTimeout"/>54 /// or <see cref="IPage.SetDefaultTimeout"/> methods.55 /// </para>56 /// </summary>...
LocatorElementHandleOptions
Using AI Code Generation
1using Microsoft.Playwright;2using System;3using System.Threading.Tasks;4{5 static async Task Main(string[] args)6 {7 using var playwright = await Playwright.CreateAsync();8 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions { Headless = false, SlowMo = 1000 });9 var page = await browser.NewPageAsync();10 var input = await page.QuerySelectorAsync("input[name='search']");11 await input.TypeAsync("Playwright");12 var searchButton = await page.QuerySelectorAsync("button[type='submit']");13 await searchButton.ClickAsync();14 var firstResult = await page.QuerySelectorAsync("div#mw-content-text > div > div:nth-of-type(1) > div:nth-of-type(1) > div > div > div > div > a");15 await firstResult.ClickAsync();16 await page.WaitForLoadStateAsync(LoadState.DOMContentLoaded);17 var elementHandle = await page.QuerySelectorAsync("h1");18 var text = await elementHandle.GetTextContentAsync();19 Console.WriteLine(text);20 await browser.CloseAsync();21 }22}
LocatorElementHandleOptions
Using AI Code Generation
1using System;2using System.Threading.Tasks;3using Microsoft.Playwright;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 BrowserTypeLaunchOptions { Headless = false });10 var page = await browser.NewPageAsync();11 await page.ClickAsync("input[name=q]", new LocatorElementHandleOptions { Timeout = 1000 });12 }13 }14}15Method Description Timeout Sets the timeout for the operation. Defaults to 30000 (30 seconds). If the timeout is reached, the operation will throw. Pass 0 to disable timeout. Force Sets to true to pass the actionability checks. Defaults to false. Strict Sets to true to treat visible: 'any' as visible: true. Defaults to false. NoWaitAfter Sets to true to disable waiting for the action to finish after the action is called. Defaults to false. If the action does not cause any effect, the method will throw. If the action causes navigation, the navigation will be aborted. If the action causes a download, the download will be canceled. If the action causes an alert, the alert will be dismissed. If the action cause
LocatorElementHandleOptions
Using AI Code Generation
1using Microsoft.Playwright;2using System.Threading.Tasks;3{4 {5 static async Task Main(string[] args)6 {7 using var playwright = await Playwright.CreateAsync();8 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions9 {10 });11 var page = await browser.NewPageAsync();12 var elementHandle = await page.QuerySelectorAsync("input[name=q]");13 await elementHandle.FillAsync("Playwright");14 await page.Keyboard.PressAsync("Enter");15 }16 }17}
LocatorElementHandleOptions
Using AI Code Generation
1using System;2using System.Threading.Tasks;3using Microsoft.Playwright;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 page = await browser.NewPageAsync();13 var element = await page.QuerySelectorAsync("input[name='q']");14 await element.TypeAsync("playwright");15 var searchButton = await page.LocatorElementHandleOptions("input[name='btnK']");16 await searchButton.ClickAsync();17 }18 }19}
LocatorElementHandleOptions
Using AI Code Generation
1using System;2using System.Threading.Tasks;3using Microsoft.Playwright;4using System.Collections.Generic;5using System.Linq;6{7 {8 static async Task Main(string[] args)9 {10 using var playwright = await Playwright.CreateAsync();11 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions12 {13 });14 var page = await browser.NewPageAsync();15 var elementHandle = await page.LocatorElementHandleOptions("input[name='q']", new LocatorElementHandleOptions16 {17 });18 Console.WriteLine(elementHandle);19 }20 }21}22using System;23using System.Threading.Tasks;24using Microsoft.Playwright;25using System.Collections.Generic;26using System.Linq;27{28 {29 static async Task Main(string[] args)30 {31 using var playwright = await Playwright.CreateAsync();32 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions33 {34 });35 var page = await browser.NewPageAsync();
LocatorElementHandleOptions
Using AI Code Generation
1using System;2using System.Threading.Tasks;3using Microsoft.Playwright;4using System.Collections.Generic;5using System.Linq;6{7 {8 static async Task Main(string[] args)9 {10 using var playwright = await Playwright.CreateAsync();11 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions12 {13 });14 var page = await browser.NewPageAsync();15 var elementHandle = await page.LocatorElementHandleOptions("input[name='q']", new LocatorElementHandleOptions16 {17 });18 Console.WriteLine(elementHandle);19 }20 }21}22using System;23using System.Threading.Tasks;24using Microsoft.Playwright;25using System.Collections.Generic;26using System.Linq;27{28 {29 static async Task Main(string[] args)30 {31 using var playwright = await Playwright.CreateAsync();32 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions33 {34 });35 var page = await browser.NewPageAsync();
LocatorElementHandleOptions
Using AI Code Generation
1using Microsoft.Playwright;2using System.Threading.Tasks;3{4 {5 static async Task Main(string[] args)6 {7 using var playwright = await Playwright.CreateAsync();8 await using var browser = await playwright.Chromium.LaunchAsync();9 var context = await browser.NewContextAsync();10 var page = await context.NewPageAsync();11 var element = await page.LocatorElementHandleOptions("input", new LocatorElementHandleOptions12 {13 });14 }15 }16}17using Microsoft.Playwright;18using System.Threading.Tasks;19{20 {21 static async Task Main(string[] args)22 {23 using var playwright = await Playwright.CreateAsync();24 await using var browser = await playwright.Chromium.LaunchAsync();25 var context = await browser.NewContextAsync();26 var page = await context.NewPageAsync();27 var element = await page.LocatorElementHandleOptions("input", new LocatorElementHandleOptions28 {29 });30 }31 }32}33using Microsoft.Playwright;34using System.Threading.Tasks;35{36 {37 static async Task Main(string[] args)38 {39 using var playwright = await Playwright.CreateAsync();40 await using var browser = await playwright.Chromium.LaunchAsync();41 var context = await browser.NewContextAsync();42 var page = await context.NewPageAsync();43 var element = await page.LocatorElementHandleOptions("input", new LocatorElementHandleOptions44 {45 });46 }47 }48}
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.
Run Playwright-dotnet automation tests on LambdaTest cloud grid
Perform automation testing on 3000+ real desktop and mobile devices online.
Most used method in LocatorElementHandleOptions
Try LambdaTest Now !!
Get 100 minutes of automation test minutes FREE!!
Was this article helpful?
