NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #1140 most downloaded on NuGet
Headless Browser .NET API
Latest stable
25.15.0
Last release 29 days ago
21 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
142 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Roll chrome to 123.0.6312.58 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2511
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v15.0.0...v15.1.0
Deprecate IPage.Target and add IPage.CreateCDPSessionAsync by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2480
Puppeteer Sharp is now using the new headless mode by default!
If you need to use the old headless mode, you can pass HeadlessMode = HeadlessMode.Shell into the LaunchOptions.
As part of this change, we will also download an extra Chrome browser, chrome-headless-shell by default, and use it for the old headless mode.
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v14.1.0...v15.0.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix Chrome for testing download URL by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2448
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v14.0.0...v14.1.0
Hopefully, this is not a big deal. But IElementHandle.ScreenshotAsync(... ScreenshotOptions) was renamed to IElementHandle.ScreenshotAsync(... Element
IElementHandle.ScreenshotAsync(... ScreenshotOptions) was renamed to IElementHandle.ScreenshotAsync(... ElementScreenshotOptions) in https://github.com/hardkoded/puppeteer-sharp/pull/2376You can now wait for a device prompt!
var promptTask = Page.WaitForDevicePromptAsync();
await Task.WhenAll(
promptTask,
Page.ClickAsync("#connect-bluetooth"));
var devicePrompt = await promptTask;
await devicePrompt.SelectAsync(
await devicePrompt.WaitForDeviceAsync(device => device.Name.Contains("My Device")).ConfigureAwait(false)
);
Now you can use AddRequestInterceptor instead of the Request page and give the ContinueAsync, AbortAsync and RespondAsync different priorities.
Page.AddRequestInterceptor(request =>
{
if (request.Url.EndsWith(".css"))
{
var headers = request.Headers;
headers["xaction"] = "continue";
return request.ContinueAsync(new Payload() { Headers = headers, }, 4);
}
return request.ContinueAsync(new Payload(), 0);
});
Page.AddRequestInterceptor(request =>
{
if (request.Url.EndsWith(".css"))
{
Dictionary<string, object> headers = [];
foreach (var kvp in request.Headers)
{
headers.Add(kvp.Key, kvp.Value);
}
headers["xaction"] = "respond";
return request.RespondAsync(new ResponseData() { Headers = headers, }, 2);
}
return request.ContinueAsync(new Payload(), 0);
});
AddRequestInterceptor will ensure that these new async listeners are executed one after the other.
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v13.0.2...v14.0.0
fix: update TextQuerySelector cache on subtree update by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2365
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v13.0.1...v13.0.2
Restore BrowserFetcher.GetExecutablePath by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2363
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v13.0.0...v13.0.1
We have a few more breaking changes in our effort to catch puppeteer.
We have a few more breaking changes in our effort to catch puppeteer.
FileChooser.Cancel was renamed to CancelAsync, and it's not Async by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2336CreateIncognitoBrowserContextAsync to pass proxy settings. by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2346Worker was renamed to WebWorker by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2356IExecutionContext.QueryObjectsAsync was removed by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2356IFrame.GetExecutionContextAsync was removed by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2356IJSHandle.ExecutionContext was removed by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2356IsVisibleAsync and IsHiddenAsync by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2349Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v12.0.0...v13.0.0
Small breaking change. But as it's a breaking change, we need to bump major. LaunchOption.TargetFilter now expects a Target instead a TargetInfo.
Chrome version is now 117.0.5938.62
Small breaking change. But as it's a breaking change, we need to bump major. LaunchOption.TargetFilter now expects a Target instead a TargetInfo.
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.6...v12.0.0
Dropping .NET Framework test builds by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2305
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.5...v11.0.6
Add missing CDPSession test by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2302
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.4...v11.0.5
Mouse improvements by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2291
IsolatedWorld by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2298AsyncDictionaryHelper by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2297Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.3...v11.0.4
Avoid unhandled exceptions on unawaited async path by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2289
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.2...v11.0.3
Fix URL for Chromium ResolveBuildIdAsync() by @mmalvik in https://github.com/hardkoded/puppeteer-sharp/pull/2288
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.1...v11.0.2
Add support for referrerPolicy in Page.GoToAsync by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2284
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v11.0.0...v11.0.1
v11 brings Google for Testing support. This introduces some breaking changes. But I think it won't be that hard to migrate your code:
v11 brings Google for Testing support. This introduces some breaking changes. But I think it won't be that hard to migrate your code:
Product was renamed to SupportedBrowser.BrowserFetcher.DefaultChromiumRevision was moved to PuppeteerSharp.BrowserData.Chrome.DefaultBuildId.BrowserFetcher.DefaultFirefoxRevision was moved to PuppeteerSharp.BrowserData.Firefox.DefaultBuildId.BrowserFetcher.DownloadsFolder was renamed to CacheDir.BrowserFecher.DownloadHost was reamed to BaseUrl.BrowserFecher.Product was reamed to Browser.BrowserFecher.LocalRevisions was reamed to GetInstalledBrowsers .RevisionInfo was reamed to InstalledBrowser.Revision was changed to BuildId.Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v10.1.2...v11.0.0
Pass expectation as the first argument by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2261
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v10.1.2...v10.1.4
Introduce chromium for MacOS arm64 downloads by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2256
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v10.1.1...v10.1.2
Reverse argument binding by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2244
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v10.1.0...v10.1.1
Introduce text query handler by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2217
XPathAsync and WaitForXPathAsync were replaced in favor of the xpath/ selector handler. @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2230ShouldDownloadAndExtractFirefoxLinuxBinary on Windows by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2232Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v10.0.0...v10.1.0
IFrame.ChildFrames was changed from a IFrame[] to IReadOnlyCollection .
IFrame.ChildFrames was changed from a IFrame[] to IReadOnlyCollection<IFrame>.Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v9.1.0...v10.0.0
Fix single file publish by @stesee in https://github.com/hardkoded/puppeteer-sharp/pull/2088
Task instead of null by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2094WaitForNetworkIdleTests.ShouldWork by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2090Detach on Disconnect by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/2105Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v9.0.2...v9.1.0
Improve DownloadFetcher executable path by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2074
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v9.0.1...v9.0.2
Fix Page.AddConsoleMessageAsync NullReferenceException by @amaitland in https://github.com/hardkoded/puppeteer-sharp/pull/2070
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v9.0.0...v9.0.1
Update permissions overrides by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2059
OverridePermission.Push was removedClipboardRead and ClipboardWrite were replaced by ClipboardReadWriteFull Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v8.0.0...v9.0.0
Add shadow DOM support by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/1994
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v7.1.0...v8.0.0
Introduce custom queries engines
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v7.0.0...v7.1.0
Puppeteer-Sharp now requires Chromium v100 or greater.
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v6.2.0...v7.0.0
Introduce Page.EmulateIdleStateAsync by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/1883
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v6.1.0...v6.2.0
Fixed issue with disposing shared screenshot task queue by @jpeirson in https://github.com/hardkoded/puppeteer-sharp/pull/1880
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v6.0.0...v6.1.0
Introduce drag and drop support by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/1830
Extensions class was renamed to PuppeteerHandleExtensions.BrowserFetcher is now IDisposable.Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v5.1.0...v6.0.0
New TargetFilter option in ConnectOptions.
TargetFilter option in ConnectOptions.BrowserFetcher.RevisionInfo was renamed to GetRevisionInfoAsync and made async.
BrowserFetcher.RevisionInfo was renamed to GetRevisionInfoAsync and made async.Launcher.GetExecutablePath was renamed to GetExecutablePathAsync and made async.Firefox version updated to 89.0a1.
Chromium revision update to Version 90.0.4403.0 (848005)
EnqueueAsyncMessages.BrowserFetcher.DownloadAsync. Default revision will be used if no argument is passed.Product to the BrowserFetcher constructor to download Chromium or Firefox.LaunchOptions now has a Product property used to launch Chromium or Firefox.Puppeteer. GetExecutablePath was removed.FileChooser.CancelAsync was renamed to Cancel and it's now sync.Revision is now a string in all BrowserFetcher methods.https://github.com/hardkoded/puppeteer-sharp/commit/5527263e1d0154ea47429a66c653599812c99f8a We are laying the ground to support Firefox. Although we
https://github.com/hardkoded/puppeteer-sharp/commit/9f4ca45edc6c6f9172036c441345423257ddbbc6 IDisposableAsync support
https://github.com/kblok/puppeteer-sharp/commit/14a4ce650c8c830c7464ad618a18eace6af0dd9a Fix orphan tasks.
https://github.com/kblok/puppeteer-sharp/commit/2d73d5d0a2b55dc96637b8d01e03d6fb973f4b86 Fix ssl when navigate to site with cert expiring after 2038.
https://github.com/kblok/puppeteer-sharp/commit/dbdbdfb05e418ce3aa7c17f299a4484a9d03f10b Add Page.EmulateTimezoneAsync.
https://github.com/kblok/puppeteer-sharp/commit/12b3645b44e602b187c3d4d9e6affc8b5d45cbc5 Add element.SelectAsync, element.EvaluateFunctionAsync, eleme
Nothing published for this version
https://github.com/kblok/puppeteer-sharp/commit/257a3fa92e3c7e41d314110c9aa33c7cd6f928a3 Expose Page.Session.
https://github.com/kblok/puppeteer-sharp/commit/32046d65c2d68768f76cf2aaabafbfe6f72558db Tracing.StartAsync without options.
https://github.com/kblok/puppeteer-sharp/commit/5cdb3cdd488e00df0ca1364d323befdfd28fdaf0 Fix SlowMo.
Nothing published for this version
Nothing published for this version
https://github.com/kblok/puppeteer-sharp/commit/32046d65c2d68768f76cf2aaabafbfe6f72558db Tracing.StartAsync without options.
root option in Page.Accessibility.SnapshotAsync().https://github.com/kblok/puppeteer-sharp/commit/8c3114776206578731354206de8730e6844e4985 Remove Mono.Posix.NETStandard dependency.
Remove Mono.Posix.NETStandard dependency
Remove Mono.Posix.NETStandard dependency
https://github.com/kblok/puppeteer-sharp/commit/e9f1ecd3ee02696d09b29e5cb8a5bd3ae2f08631 BigInteger support.
https://github.com/kblok/puppeteer-sharp/commit/54629a666fdce7c222ee69ae61ae12d6ed96b802 Response.Headers changed from Dictionary to Dictionary
Dictionary<string, object> to Dictionary<string, string>Nothing published for this version
https://github.com/kblok/puppeteer-sharp/commit/c76e244738635233cfbf4dac06e605e9b2d24970 Introduce Popup event.
https://github.com/kblok/puppeteer-sharp/commit/61fbd27f5ce3268eeae141f02e8213a8da379a6e No need to fix file permissions on Mac.
https://github.com/kblok/puppeteer-sharp/commit/ec353c3ef0699cb1e830d2c521f9a47bcdd9a29d Fix ScrollIntoViewIfNeededAsync script
https://github.com/kblok/puppeteer-sharp/commit/805784320a468b430420a4e2f55917c2a20f6a0e Support waitUntil option for Page.SetContentAsync.
Page.SetContentAsync.Disconnected.Task InitializeAsync(string url, IConnectionOptions connectionOptions, ILoggerFactory loggerFactory = null).https://github.com/kblok/puppeteer-sharp/commit/637567198d3ecad2a25f46350dabc441dc3f7e0f Snapshot the accessibility tree.
JToken.ToObject<T>(bool camelCase).Page.Frames now is based on a ConcurrentDictionary. With this change, the Frame order is no longer guaranteed.https://github.com/kblok/puppeteer-sharp/commit/f764ff31c180cd6dc72cfcb5fcab5c9a9500e244 Introducing Burst mode.
var screenShotOptions = new ScreenshotOptions
{
FullPage = true,
BurstMode = true
};
await page.GoToAsync("https://www.google.com");
for(var x = 0; x < 100; x++)
{
await page.ScreenshotBase64Async(screenShotOptions);
}
await page.SetBurstModeOffAsync();
EvaluateFunctionAsync and EvaluateExpressionAsync won't try to infer the output type when used without generics. It will return a ** JToken** instead.
A piece of code like this:
int x = page.EvaluateExpressionAsync("1");
Will need to be replaced by one of these two options:
int x = page.EvaluateExpressionAsync<int>("1");
int x = page.EvaluateExpressionAsync("1").ToObject<int>();
https://github.com/kblok/puppeteer-sharp/commit/339c7dc2daf0114ce763ed8ef6acd9cb0ecfa24a Roll Chromium to r588429.
https://github.com/kblok/puppeteer-sharp/commit/e2c114cc1df69cfeea4093b2dc3bd982f0e2ccb5 Typing emojis.
One column per quarter.