NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #1127 most downloaded on NuGet
Headless Browser .NET API
Latest stable
25.15.0
Last release 1 months 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.
New Feature: Allow Page.SetGeolocationAsync(null) to remove the geolocation override (#15590) by @kblok in https://github.com/hardkoded/puppeteer-shar
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.14.0...v25.15.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix: pass SixLabors license key to NuGet publish builds by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3613
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.13.1...v25.14.0
Expose stack trace on PageErrorEventArgs by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3612
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.13.0...v25.13.1
Update WebDriverBiDi.NET dependency to v0.0.61 by @jimevans in https://github.com/hardkoded/puppeteer-sharp/pull/3589
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.11.0...v25.12.0
Remove CodeFactor badge from README by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3581
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.10.0...v25.11.0
fix: set frame content without document.write (#15358) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3565
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.8.0...v25.10.0
chore: bump version to 25.8.0 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3561
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.7.0...v25.8.0
fix: roll Firefox to 153.0.4 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3554
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.6.0...v25.7.0
Replace hand-rolled retry/timeout plumbing with RxSharp by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3520
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.5.0...v25.6.0
fix: PWA launch returning a page with an empty URL on Windows by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3529
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.4.0...v25.5.0
Roll Chrome to 151.0.7922.47 (#15237) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3524
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.3.4...v25.4.0
Fix #3517: CreateCDPSessionAsync never delivers events for worker targets by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3518
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.3.3...v25.3.4
Fix Native AOT crash from missing JsonSerializable registrations by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3516
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.3.2...v25.3.3
fix: CDP-only netstandard2.0 build failure with System.Threading.Channels by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3512
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.3.0...v25.3.1
chore: roll Firefox to 152.0.4 (upstream #15158, #15195) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3510
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.2.1...v25.3.0
feat: add WaitForFunctionAsync to WebWorker (upstream #15100) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3484
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.1.2...v25.2.1
fix: open a new window when creating a page with no existing targets by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3481
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.1.1...v25.1.2
Avoid leaking TargetChangedArgs event handlers by @jnyrup in https://github.com/hardkoded/puppeteer-sharp/pull/3476
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.1.0...v25.1.1
Make ICdpHandle interface public by @amaitland in https://github.com/hardkoded/puppeteer-sharp/pull/3472
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v25.0.4...v25.1.0
chore: track upstream #14910 (remove deprecated Browser.isConnected()) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3464
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v24.42.0...v25.0.4
feat: roll Firefox to 150.0 stable by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3407
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v24.40.0...v24.42.0
Improve memory usage by @albyrock87 in https://github.com/hardkoded/puppeteer-sharp/pull/3393
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v24.39.1...v24.40.0
Add includeAll parameter to PagesAsync by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3380
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v24.39.0...v24.39.1
Bump Firefox nightly to 150.0a1 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3376
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v24.38.8...v24.39.0
Nothing published for this version
Add support for 'Default' SameSite cookie property (#14637) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3151
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v21.1.0...v21.1.1
Deprecate Cookie attribute SameParty (#14550) by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3142
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v21.0.1...v21.1.0
Use stable WebDriverBiDi-Relaxed 0.0.41 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/3125
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v21.0.0...v21.0.1
WebDriver BiDi protocol support for Firefox!!!!! PuppeteerSharp now supports the WebDriver BiDi protocol, enabling Firefox automation alongside existi
Minor Changes
Mark LogProcess property as obsolete by @Copilot in https://github.com/hardkoded/puppeteer-sharp/pull/3072
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.2.5...v20.2.6
Don't assume Params type by @bgrainger in https://github.com/hardkoded/puppeteer-sharp/pull/3028
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/20.2.4...v20.2.5
Remove redundant .ToArray()/.ToList() by @IliaBrahinets in https://github.com/hardkoded/puppeteer-sharp/pull/2944
LocalNetworkAccess to OverridePermission.cs by @miroljub1995 in https://github.com/hardkoded/puppeteer-sharp/pull/2963Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.2.2...20.2.4
Add support to ARM browsers by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2937
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.2.1...v20.2.2
Fix Invalid referrerPolicy error in latest versions of Chromium by @Manny651 in https://github.com/hardkoded/puppeteer-sharp/pull/2924
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.2.0...v20.2.1
Chrome 138 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2912 *
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.1.3...v20.2.0
Change WebSocketTransport constructor to protected by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2889
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.1.2...v20.1.3
Fix low surrogate on post data by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2887
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.1.1...v20.1.2
Update publish-docs.yml versions by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2876
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.1.0...v20.1.1
Roll chrome to 132 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2871
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.0.5...v20.1.0
Update sponsors by @github-actions in https://github.com/hardkoded/puppeteer-sharp/pull/2815
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.0.4...v20.0.5
Roll chrome to 130 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2811 *
What's new
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.0.3...v20.0.4
Add Slow 4G / Fast 4G predefined network conditions by @campersau in https://github.com/hardkoded/puppeteer-sharp/pull/2787
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.0.2...v20.0.3
Back up user.js as well by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2773
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v20.0.0...v20.0.2
Nothing published for this version
There are, technically speaking, some breaking changes. I hope it's not a big deal for you.
There are, technically speaking, some breaking changes. I hope it's not a big deal for you.
By @campersau in https://github.com/hardkoded/puppeteer-sharp/pull/2749
If you implemented a custom IConnectionTransport. The new signature of SendAsync is Task SendAsync(byte[] message);
This matches the type in Puppeteer.
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v19.0.2...v20.0.0
Return whether the permissions fix was executed successfully by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2754
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v19.0.1...v19.0.2
Fix AOT build by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2747
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v19.0.0...v19.0.1
Newtonsoft JSON classes were also used in our API, so your code might have some breaking changes.
v19 comes with one of the most significant changes made to this library. We are moving away from Newtonsoft JSON in favor of System.Text.Json. The motivation behind this change is that it would get us closer to AOT support.
If you are using your own classes to interact with the browser through EvaluateFunctionAsync or similar, you will have to provide your own JsonSerializerContext to puppeteer using the static Puppeteer.ExtraJsonSerializerContext property.
For instance.
Puppeteer.ExtraJsonSerializerContext = DemoJsonSerializationContext.Default;
await using var browser = await Puppeteer.LaunchAsync();
await using var page = await browser.NewPageAsync();
var result = await page.EvaluateFunctionAsync<TestClass>("test => test", new TestClass { Name = "Dario"});
Console.WriteLine($"Name evaluated to {result.Name}");
The serializer would look like this:
public class TestClass
{
public string Name { get; set; }
}
[JsonSerializable(typeof(TestClass))]
public partial class DemoJsonSerializationContext : JsonSerializerContext
{}
For more information about JsonSerializerContext see How to use source generation in System.Text.Json.
JSON is critical for PuppeteerSharp. It's how we communicate with the browser, so changing the library used to perform this communication is quite risky. Newtonsoft JSON classes were also used in our API, so your code might have some breaking changes.
JToken was replaced with JsonElementJToken was the default type for functions like EvaluationFunctionAsync, EvaluateExpressionAsync or JsonAsync, when the generic function was not used.
Before:
var objectPopulated = await Page.EvaluateExpressionAsync("var obj = {a:1}; obj;");
Assert.AreEqual(1, objectPopulated["a"]);
Now:
var objectPopulated = await Page.EvaluateExpressionAsync("var obj = {a:1}; obj;");
Assert.AreEqual(1, objectPopulated.Value.GetProperty("a").GetInt32());
JsonElement instead of objectI found that it's easy to consume JsonElement instead of objects that are really JsonElements.
Before
var result = await Page.EvaluateExpressionAsync<object[]>("result");
Assert.AreEqual("Meta", result[0]);
Assert.AreEqual("MetaLeft", result[1]);
Assert.AreEqual(true, result[2]);
After
var result = await Page.EvaluateExpressionAsync<JsonElement[]>("result");
Assert.AreEqual("Meta", result[0].GetString());
Assert.AreEqual("MetaLeft", result[1].GetString());
Assert.AreEqual(true, result[2].GetBoolean());
Previously, Puppeteer incorrectly normalized whitespaces in ARIA selectors in a way that did not not allow distinguishing between the following two HTML structures:
<p> text<p>
<p><span> </span><span> </span>text<p>
In the first case, the spaces are not part of the element's textual content, and the element should be found via aria/text.
In the second case, the spaces are part of the p element and the query aria/\u00A0\u00A0text should find it while aria/text should not. The whitespace normalization in Puppeteer would previously prevent searching for the element with whitespaces in the textual content.
Related: the step 2.F of https://www.w3.org/TR/accname-1.2/#computation-steps defines how child elements contribute to the parent element's computed name.
If you need the old behavior, apply selector.replace(/ +/g, ' ').trim() to your ARIA selector.
This change will get us closer to WebDriver Bidi Support.
Nothing published for this version
Nothing published for this version
Bump chrome to 127 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2717
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v18.0.5...v18.1.0
Nothing published for this version
Await handle on disposal by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2699
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v18.0.4...v18.0.5
Update sponsors by @github-actions in https://github.com/hardkoded/puppeteer-sharp/pull/2690
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v18.0.3...v18.0.4
Chrome 125 proved to be problematic for windows users. We are rolling back to Chrome 124.
BrowserContext.IsClosed returns true when a context is not closed by @IliaBrahinets in https://github.com/hardkoded/puppeteer-sharp/pull/2668Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v18.0.2...v18.0.3
Update sponsors by @github-actions in https://github.com/hardkoded/puppeteer-sharp/pull/2647
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v18.0.1...v18.0.2
Roll chrome to 125 by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2637
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v18.0.0...v18.0.1
Replace WebClient with HttpClient by @kblok in https://github.com/hardkoded/puppeteer-sharp/pull/2615
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v17.0.0...v18.0.0
Nothing published for this version
Request.Failure was renamed to Request.FailureText.
Full Changelog: https://github.com/hardkoded/puppeteer-sharp/compare/v15.1.0...v16.0.0
One column per quarter.