Join the 1-day Testing & QA Summit featuring 15+ Expert Speakers.Register for FREE! 
How to use LocatorElementHandleOptions class of Microsoft.Playwright package
Best Playwright-dotnet code snippet using Microsoft.Playwright.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 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 LaunchOptions10 {11 });12 var page = await browser.NewPageAsync();13 await page.FillAsync("input[title='Search']", "Playwright");14 await page.ClickAsync("input[type='submit']");15 await page.ClickAsync("text=Playwright");
LocatorElementHandleOptions
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();10 var page = await browser.NewPageAsync();11 var search = await page.LocatorElementHandleOptionsAsync("input[name=q]");12 await search.TypeAsync("Hello World!");13 await page.PressAsync("input[name=q]", "Enter");14 await page.ScreenshotAsync("screenshot.png");15 await browser.CloseAsync();16 }17 }18}
LocatorElementHandleOptions
Using AI Code Generation
1using Microsoft.Playwright;2{3 {4 static async Task Main(string[] args)5 {6 using var playwright = await Playwright.CreateAsync();7 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions8 {9 });10 var page = await browser.NewPageAsync();11 var element = await page.QuerySelectorAsync("h1");12 var text = await element.TextContentAsync();13 Console.WriteLine(text);14 }15 }16}17using Microsoft.Playwright;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 BrowserTypeLaunchOptions24 {25 });26 var page = await browser.NewPageAsync();27 var element = await page.QuerySelectorAsync("h1", new LocatorElementHandleOptions28 {29 });30 var text = await element.TextContentAsync();31 Console.WriteLine(text);32 }33 }34}
LocatorElementHandleOptions
Using AI Code Generation
1using Microsoft.Playwright;2using Microsoft.Playwright.Helpers;3using System;4using System.Collections.Generic;5using System.Linq;6using System.Text;7using System.Threading.Tasks;8{9 {10 static async Task Main(string[] args)11 {12 using var playwright = await Playwright.CreateAsync();13 await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions14 {15 });16 var page = await browser.NewPageAsync();17 await page.ClickAsync("input[name=q]");18 await page.TypeAsync("input[name=q]", "Playwright");19 await page.PressAsync("input[name=q]", "Enter");20 var locator = page.Locator("a");21 var locatorElementHandles = await locator.GetElementHandlesAsync(new LocatorElementHandleOptions22 {23 });24 foreach (var locatorElementHandle in locatorElementHandles)25 {26 Console.WriteLine(await locatorElementHandle.GetAttributeAsync("href"));27 }28 await browser.CloseAsync();29 }30 }31}
LocatorElementHandleOptions
Using AI Code Generation
1using System;2using System.Threading.Tasks;3using Microsoft.Playwright;4using Microsoft.Playwright.Core;5using Microsoft.Playwright.Helpers;6using Microsoft.Playwright.Transport.Channels;7using Microsoft.Playwright.Transport.Protocol;8using Microsoft.Playwright.Transport;9using Microsoft.Playwright.Transport.Channels;10using Microsoft.Playwright.Transport.Protocol;11using Microsoft.Playwright.Helpers;12using Microsoft.Playwright.Core;13using Microsoft.Playwright;14using System.Threading.Tasks;15using System;16using System;17using System.Threading.Tasks;18using Microsoft.Playwright;19using Microsoft.Playwright.Core;20using Microsoft.Playwright.Helpers;21using Microsoft.Playwright.Transport.Channels;22using Microsoft.Playwright.Transport.Protocol;23using Microsoft.Playwright.Transport;24using Microsoft.Playwright.Transport.Channels;25using Microsoft.Playwright.Transport.Protocol;26using Microsoft.Playwright.Helpers;27using Microsoft.Playwright.Core;28using Microsoft.Playwright;29using System.Threading.Tasks;30using System;31using System;32using System.Threading.Tasks;33using Microsoft.Playwright;34using Microsoft.Playwright.Core;35using Microsoft.Playwright.Helpers;36using Microsoft.Playwright.Transport.Channels;37using Microsoft.Playwright.Transport.Protocol;38using Microsoft.Playwright.Transport;39using Microsoft.Playwright.Transport.Channels;40using Microsoft.Playwright.Transport.Protocol;41using Microsoft.Playwright.Helpers;42using Microsoft.Playwright.Core;43using Microsoft.Playwright;44using System.Threading.Tasks;45using System;46using System;47using System.Threading.Tasks;48using Microsoft.Playwright;49using Microsoft.Playwright.Core;50using Microsoft.Playwright.Helpers;51using Microsoft.Playwright.Transport.Channels;52using Microsoft.Playwright.Transport.Protocol;53using Microsoft.Playwright.Transport;54using Microsoft.Playwright.Transport.Channels;55using Microsoft.Playwright.Transport.Protocol;56using Microsoft.Playwright.Helpers;57using Microsoft.Playwright.Core;58using Microsoft.Playwright;59using System.Threading.Tasks;60using System;61using System;62using System.Threading.Tasks;63using Microsoft.Playwright;64using Microsoft.Playwright.Core;
LocatorElementHandleOptions
Using AI Code Generation
1LocatorElementHandleOptions locatorElementHandleOptions = new LocatorElementHandleOptions();2locatorElementHandleOptions.Timeout = 10000;3locatorElementHandleOptions.Visibility = ElementHandleVisibility.Visible;4locatorElementHandleOptions.State = ElementHandleState.Attached;5locatorElementHandleOptions.Stable = true;6locatorElementHandleOptions.NoWaitAfter = true;7locatorElementHandleOptions.Force = true;8locatorElementHandleOptions.Content = "Click me";9locatorElementHandleOptions.Opposite = false;10LocatorElementHandleOptions locatorElementHandleOptions = new LocatorElementHandleOptions();11locatorElementHandleOptions.Timeout = 10000;12locatorElementHandleOptions.Visibility = ElementHandleVisibility.Visible;13locatorElementHandleOptions.State = ElementHandleState.Attached;14locatorElementHandleOptions.Stable = true;15locatorElementHandleOptions.NoWaitAfter = true;16locatorElementHandleOptions.Force = true;17locatorElementHandleOptions.Content = "Click me";18locatorElementHandleOptions.Opposite = false;19LocatorElementHandleOptions locatorElementHandleOptions = new LocatorElementHandleOptions();20locatorElementHandleOptions.Timeout = 10000;21locatorElementHandleOptions.Visibility = ElementHandleVisibility.Visible;22locatorElementHandleOptions.State = ElementHandleState.Attached;23locatorElementHandleOptions.Stable = true;24locatorElementHandleOptions.NoWaitAfter = true;25locatorElementHandleOptions.Force = true;26locatorElementHandleOptions.Content = "Click me";27locatorElementHandleOptions.Opposite = false;28LocatorElementHandleOptions locatorElementHandleOptions = new LocatorElementHandleOptions();29locatorElementHandleOptions.Timeout = 10000;30locatorElementHandleOptions.Visibility = ElementHandleVisibility.Visible;31locatorElementHandleOptions.State = ElementHandleState.Attached;32locatorElementHandleOptions.Stable = true;33locatorElementHandleOptions.NoWaitAfter = true;34locatorElementHandleOptions.Force = true;35locatorElementHandleOptions.Content = "Click me";36locatorElementHandleOptions.Opposite = false;37LocatorElementHandleOptions locatorElementHandleOptions = new LocatorElementHandleOptions();38locatorElementHandleOptions.Timeout = 10000;
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 methods in LocatorElementHandleOptions
Try LambdaTest Now !!
Get 100 minutes of automation test minutes FREE!!
Was this article helpful?
