Repository navigation
Releases
Releases · lightpanda-io/browser
1.0.4
Behavior changes
- Requests to the Fetch "bad ports" (ssh, smtp, pop3, imap, …) are now refused for every request, not only WebSocket.
window.postMessagenow honorstargetOrigin.- A cross-site response can no longer set a
SameSitecookie other thanNone. - Proxy and server credentials are tracked separately, so proxy credentials are no longer sent to the server after a redirect.
- An
about:blank(or src-less) iframe now gets itscontentWindowandcontentDocumenteven without--load-resources iframe. Its HTTP and WebSocket requests are blocked while iframe loading is off. - An HTTP status from 600 to 999 (e.g. LinkedIn's
999) is now reported as-is instead of0. - Trusted
mousedown,mouseup,clickanddblclicknow stop at the first disabled form control, as in Chrome. - Element clicks and hovers from tools now hit the element's center instead of
(0, 0). document.readyStateis nowinteractivewhen deferred scripts run.Network.setUserAgentOverridenow logs a warning when a restricted user agent is ignored.- The HTTP server parses requests more strictly and its routes are guarded against DNS rebinding.
CDP
- Several page targets in one browser context. Console, exception and network events are routed to the right target, and a frame id from another target is rejected
- Accessibility:
ignoredReasonsnow match Chrome (ariaHiddenElement,ariaHiddenSubtree,inertElement,notRendered,notVisible) - Lone surrogate escapes in JSON (
"\udc00") are accepted instead of closing the connection LP.waitUntiland asettledlifecycle eventbeaconadded toLP.configureLoading- A closed browser context no longer leaves its viewport override for the next one
LPcommands described in/json/protocol
Serve / CLI
--wait-until settled(experimental): waits for load, then for the work that can still change the page. Interval timers, long timers and intersection observers don't hold it--v8-gc-hint-floor-mbreplaces the fixed 1 MiB GC hint floor. Off infetch--experimental-features animation: fireanimationstart,animationendandanimationcancelfor CSS animations- Bash 3.2 (macOS) filename completion
New Web APIs
AnimationEventand CSS animation events (behind--experimental-features animation)ClipboardEventInputEvent.getTargetRanges()execCommand('insertParagraph')getComputedStyle().contentresolved from the cascade
Web API behavior / fixes
- Text editors: CKEditor works, and clicks, focus and Tab place the caret in a
contenteditable(Slate, Draft.js) contenteditable: Backspace and Delete merge blocks (nested ones too), side-by-side lists merge, Enter in an empty list item outdents itexecCommand: runs of spaces and spaces at line edges become , so they stay visibleinnerTextkeeps spaces when CSSwhite-spacepreserves them, and puts a newline between rows ofthead,tbodyandtfoot:definedfollows the custom element state; customized built-ins (<button is=...>) now upgrade[CEReactions]forcreateElement/createElementNS; the reactions queue is no longer drained when a constructor returnsa.hashanda.search(and<area>) return""for a lone#or?history.pushState(undefined)no longer breakshistory.state; state that JSON can't encode throwsDataCloneErrorimport()of an already available module settles in a later task, as in Chromewindow.<id>on an iframe's window looks up the iframe's document- Functions called from a realm whose frame is gone no longer crash (
import(),import.meta,postMessage,location) - WebSocket: fragmented messages are reassembled; the server's
Sec-WebSocket-Protocolis checked against the offered list - CORS responses filter their headers
Response.clone()on a stream;pipeTo/pipeThroughfixes- Input
stepUp/stepDownwith fractional steps (0.1 + 0.2gives0.3) matchMedia("")always matches- SVG
getCTM()/getScreenCTM()return an identity matrix on a detached element frameandbasefontare serialized as void elementsdocument.createEvent('inputevent')is rejected;PromiseRejectionEventrequires its optionsnew CSSStyleSheet()sheets are the only onesreplace()acceptsIntersectionObserver: the first check runs on the next tick
Tools / MCP
treedelta: true: returns only the lines that changed since the last call- The page's WebMCP tools are reported in a tool result whenever they change
- Actions that open a window late (after a fetch or a timer) now follow it; new
popupstool lists and switches windows clicksays when the element is disabled or not rendered- Tool arguments are type-checked, and every error names the argument and the problem
treeandmarkdownkeep content that is rendered despitehiddenoraria-hidden- Markdown:
<ol start>, multi-paragraph blockquotes, a blank line before--- - MCP over HTTP: tool output streamed over SSE (the
runtool streams console lines),logging/setLevel, andnotifications/cancellednow stops the call in flight - The
runtool description explains how to load pages in parallel
Performance / stability
- Style caches are invalidated per property group, and a geometry change no longer resets the whole geometry cache
- Smaller CSS declarations (~500 KB saved on a style-heavy site); property names are ids, and style matching compares ids (7%+ faster rebuilds on most frameworks)
- XHR takes the response body instead of copying it
- XPath parsing allocates less
- Crash fixes: abort during a gated transfer, a UAF in custom element upgrade
- The crash reporter exits non-zero when it can't start
curl
Release
- macOS builds run on macOS 15; the Intel build targets baseline x86_64, fixing "Illegal instruction" on older CPUs
- Release candidates (
1.0.4-rc1) are now published
1.0.4-rc1
Merge pull request #4584 from lightpanda-io/pre-release
1.0.3
Behavior changes
serve: the--http-max-concurrentdefault now follows--cdp-max-connections(8× it, between 40 and 256). With the default 16 connections it is 128.fetch --dump markdownnow asks the server for markdown (Accept: text/markdown,...). Atext/markdownresponse is dumped as-is. Not sent with--dump-selector,--wait-selectoror--wait-script.Accessibility.getPartialAXTreenow honorsfetchRelatives, as Chrome does: it returns the node and its relatives, no longer the whole subtree. UsegetFullAXTreeorgetChildAXNodesfor a subtree.DOM.querySelectorwith no match now returnsnodeId: 0instead of an error, as Chrome does.- Touch event handlers (
ontouchstart, …) are removed fromdocumentand elements: Lightpanda doesn't emulate a touch device. navigator.sendBeaconnow checks its arguments. Beacons are still not sent unless--load-resources beaconis set.- The HTTP cache database is deleted and rebuilt when its schema version changes.
waitForStatenow reports a timeout instead of always answering that the page reached the state.- MCP over HTTP: a request on a session closed with
DELETEnow gets a 404 instead of starting a new session. fetch()andnew Request()with a body on GET or HEAD now throw aTypeError.- Scripts inserted from an isolated world (Playwright
setContent,appendChild) now run in the main world. - Event listeners now run in their own world's context, so Playwright's
focus()andselectOption()fire React'sonFocus/onChange.
New Web APIs
AudioContext(WAV only)- Payment Request API:
PaymentRequest,PaymentResponseand their events, behaving like Chrome with no payment app installed NavigateEventonnavigation(intercept()is not implemented)PerformanceNavigationTimingentry for the documentdocument.execCommand:insertText,delete,forwardDelete,selectAll,insertLineBreak, and thestyleWithCSS,useCSSanddefaultParagraphSeparatorsettings. Other commands returnfalseimage.decode()HTMLElement.isContentEditable(real value),HTMLElement.spellcheck,document.designModeTouchconstructor andTouchEventtouch listselementFromPoint/elementsFromPointonShadowRoot- SVG
getBBox() HTMLFrameElement,SecurityPolicyViolationEvent, a stubPath2Dnavigator.mimeTypes(emptyMimeTypeArray)img.sizes;link.relList.supports()fordns-prefetch,preconnectandprefetchHTMLFieldSetElement.elements;abbr,mark,small,wbrand other HTMLElement-only tags are nowHTMLElementinstead ofHTMLUnknownElementonmouseenterandonmouseleavehandlers- Web Crypto:
raw-secretandraw-publickey formats;CryptoKeyis now serializable (structuredClone,postMessage, IndexedDB) MessagePortis now transferableTextDecoderStreamdecodes every encodingTextDecodersupports, with state kept across chunksXMLSerializernow writes XML instead of HTML- WebMCP follows the current spec:
document.modelContext,getTools(),toolchange,registerToolreturns a promise - CSS: native nesting, color parsing, more known properties (
CSS.supports, unknown property errors)
Web API behavior / fixes
- Layout: flex-shrink, horizontal margins,
left/right/inset, and widths from text measurement. Widths are relative to the containing box. Out-of-flow children no longer size their parent, and block boxes start at their parent's left edge positionis now read from stylesheets, not only from the inline style (offsetParent,getComputedStyle)- An iframe without size is now 300×150, and its box is the frame's viewport, so Playwright can click inside it
Range.getClientRects()now returns one rect per selected element or text nodeelementFromPointreturnsnulloutside the viewport- Textarea
scrollHeightnow counts its text, for auto-sizing textareas - Typing and
Input.insertTextnow insert text intocontenteditableelements anddesignModedocuments; Ctrl-A selects all - Selectors:
:in-range/:out-of-range,:default,:scopeon a document;:required/:optionalonly on form controls;[attr^=""],[attr$=""]and[attr*=""]match nothing - Forms:
stepMismatch, Chrome-liketype=emailvalidation (withmultiple),readonlyfields skip validation, emptyactionmeans the document's URL margin,padding,insetandborder-*shorthands now expand into longhandsstyle.x = nullandsetProperty(name, null)now remove the declaration- Media queries accept fractional lengths (
max-width: 767.98px) - Changing a
<style>'s text now clears the style cache - Un-rendered light DOM (slot fallback with assigned content, unslotted children) is now treated as hidden
- A closed
<details>keeps its loose text out ofinnerText <a>and<area>URL setters keep userinfo and reject invalid values; better URL port handlingnavigation.navigate()with a fragment now updateslocationand the entry URLdatasetrejects invalid names and maps a leading capital todata--isEqualNodecompares namespace URIsDOMTokenList.forEachsees mutations made by its callbackselect/selectionchangeevents are now dispatched asynchronously;eventPhaseisAT_TARGETin direct dispatch<dialog>:show()on an open dialog does nothing,closefires asynchronouslyxhr.responseType = 'document'now parses HTML into anHTMLDocumentinnerHTML = ""on an<html>element creates<head>and<body>document.fonts.load()no longer fires load events when there are no font facesnavigator.appVersionnow starts with5.0- Properties moved to the right interfaces (e.g.
titleonDocument); the global's prototype is nowWindow.prototype new WebSocket(url, ['a', 'a'])throws aSyntaxError- A string longer than V8 accepts throws a
RangeErrorinstead of aborting import()of a module that threw rejects with the module's exception- Inline scripts report errors at their position in the document
- Timers run on the initial
about:blankpage - Pending timer cap raised from 8192 to 65536
Scripts
- The parser runs microtasks before preparing a
<script>, so aMutationObservercan change its type first - Dynamic scripts with
async=falserun in order; dynamic scripts can't bedefer; inline modules run like external ones - Already-fetched async scripts now run from a task, after the markup that follows them
<script src="">fireserrorinstead of fetching the page
Cookies / HTTP
- A non-secure origin can't set or overwrite a
Securecookie (RFC 6265bis) - The cookie jar evicts old cookies past Chrome's limits instead of failing the response
- A cookie with neither a name nor a value is ignored; IP addresses are each their own site
- The HTTP cache skips
Rangerequests and URLs with userinfo;Varymatching fixed --http-cache-set-cookie=skip|store|stripadded (experimental,storeandstripneed--experimental-features)- DNS lookups are shared across connections
- The robots.txt cache now expires after 24 hours
- Web Bot Auth:
Signature-Agentis the quoted origin, and each signed request has a nonce
CDP
- File downloads (
Browser.setDownloadBehavior), saved to disk or streamed - Accessibility domain completed:
getRootAXNode,getAXNodeAndAncestors,getChildAXNodes; shadow DOM is now walked in the AX tree Page.setDocumentContent(Puppeteerpage.setContent())Performance.getMetrics(Timestamp,JSHeapUsedSize,JSHeapTotalSize)Input.setInterceptDragsandInput.dispatchDragEventCSS.getComputedStyleForNodeDOM.getContentQuadsandDOM.getBoxModelfor text nodesPage.navigateToHistoryEntryrestores a same-document entry in placeFetch.fulfillRequestnow stores the response's cookiesNetwork.loadingFinished.encodedDataLengthnow reports the bytes received- An unknown context returns Chrome's error code and message
/json/protocolupdated
Tools / MCP
downloadtool, streamed to diskpageToolsandcallPageTool: list and call the page's WebMCP toolsclassify,acceptCookiesandlogintools (TypeSafe Jev withTYPESAFE_API_KEY)- MCP
runtool: run a PandaScript by source or by path - MCP stdio:
notifications/cancelledstops the in-flight tool call tree: ARIAcheckedandexpandedstatesinteractiveElementsreports whether an element is in a fixed or sticky overlay- Structured data: microdata
- A missing required argument is now named in the error;
nullmeans unset - A
backendNodeIdwhose node left the document is rejected - Markdown: empty code spans dropped, no inline markup inside code
- Redacted dumps keep an empty password field empty
Agent
- xAI (Grok) provider,
XAI_API_KEY - LLMD provider and Parallel search (
PARALLEL_API_KEY) - REPL tool commands take a prompt (
/click the add to cart button), recorded with explicit selectors for/save - The REPL exits when its terminal goes away
- Ctrl-C and timeouts now stop a script that loops after an
await
WebDriver
POST /session/{id}/window
Performance / stability
- Compiled scripts (classic and modules) are stored in the HTTP cache
- Single-threaded arena allocator (~10% faster on WPT)
- Faster V8 ↔ Zig calls (~10%)
- Faster style matching, selector lists, class and sibling selectors,
getTag() - Inline transforms no longer drop the cascade's memos
- Cookie jar stored per site
- Arenas free blocks they can't keep instead of keeping them in place
- Response bodies are no longer buffered in the transfer's arena
- Faster startup on macOS
- Crash and UAF fixes:
call_arenain nested calls, EventSource double abort,document.write, structured-clonedFileList,DataCloneErrormessages, WebMCP tool errors...
1.0.2
Behavior changes
- JS page errors now log under a new
page_errorscope at WARN (silence with--log-filter). - Each top-level page now has its own session history; a second page no longer shows up in the first page's back/forward.
--block-private-networksnow blocks more non-routable ranges (CGNAT, benchmarking, multicast, reserved, NAT64).no-corsfetches with a non-safelisted method are now rejected.- An unreadable
--http-cache-dirdatabase is now discarded instead of exiting. - Console values written to the log are now escaped and capped.
New Web APIs
- Web Crypto: Ed25519, X25519, ECDSA, RSA-PSS, RSASSA-PKCS1-v1_5,
wrapKey/unwrapKey+ AES-KW; EC and RSA-OAEP import/export - WebCodecs,
OfflineAudioContext, WebVTT improvements - XML document parsing
setRangeText()on<input>and<textarea>;textarea.textLengthHTMLProgressElementvalue/max/position;HTMLOptionElement.index; missing table APIsdocument.hasFocus();window.outerWidth/outerHeight/screenX/screenY/screenLeft/screenTop:nth-child(An+B of S)and:nth-last-child(An+B of S)PermissionStatusis now anEventTarget;DOMExceptionis now structured-cloneable;ImageDataoverload- Missing global event handlers added to
window,documentandbody
Web API behavior / fixes
- Element widths are now resolved relative to their parent (block, inline, floats, %, min/max-width, basic flex)
- Client rects (
getBoundingClientRect,getClientRects) are now viewport-relative - Mouse events now reach into shadow DOM and iframes
- Escape now closes the topmost modal dialog
- Iframes inside a shadow root now load when their host connects
replaceWithcompliance and cross-document adoption;isEqualNode(null)now returns falseinsertAdjacentHTMLnow works on SVG elements- Trusted key events now report Chrome's legacy
keyCode/which/charCode - Text selection offsets now count UTF-16 code units
TextDecodernow only strips a BOM for UTF-8/UTF-16form.elementsnow lists fieldset, object and output- Sequence arguments now accept any iterable
- Better
getComputedStyle().transform - Fixed CSS nested rule parsing; escapes are now decoded in unquoted attribute selectors
- Cookies are now sent longest path first, then oldest first
- 401/407 responses are now delivered as-is when no auth challenge header is present
CDP
Fetch.continueRequestinterceptResponseis now supportedFetch.continueWithAuthwithDefault/CancelAuthnow delivers the original 401/407, as Chrome doesRuntime.exceptionThrownis now emitted for unhandled promise rejections, with the context the exception was thrown inLog.entryAddedis now emitted for resources that fail to loadDOM.scrollIntoViewIfNeededis now supported (previously a no-op)LP.getPageStatusadded: page issue summary (JS errors, skipped resources, fetch stats). Also included infetchoutput when--jsonis used- Custom ARIA states and focusability are now exposed in the AX tree
- Non-UTF-8 status text and headers are now reported as strings rather than a byte array
- Permission overrides are now cleared when a browser context closes
Serve / CLI
serve --unix-socket <path>added: CDP over a Unix domain socket--remote-allow-originsadded: allow CDP connections that send anOriginheader (rejected by default), matching Chromeservenow honors--cookie-jar: the jar is saved when a connection closes. With multiple connections, last write winsfetch --dump structured_dataaddedfetch --markdown-alternateadded: follow a page'stext/markdownalternate.text/markdowndocuments are now dumped as-is
Tools
markdowntool:alternateoption added- A failed
gotonow closes the page - Tree tool: links kept inside headings, multi-line names kept on one line
Performance / stability
- Reworked TaggedOpaque (less memory)
- The scheduler now runs from a snapshot and no longer runs after every script evaluation
- Faster forgiving base64 decode
- UAF fixes: blob navigation, attribute change, file→blob layout; recursive close during load
- Script rejects no longer run microtasks mid-evaluation
1.0.1
Behavior changes
setImmediateandclearImmediatewere removed (deprecated, not part of the web platform).- MCP and agent modes now load external stylesheets by default.
- Max HTTP redirects raised from 10 to 20, matching the Fetch spec.
- Unsupported protocols are no longer navigated to;
javascript:URLs are run instead of navigated to.
New Web APIs
- Web Locks
- Compression Streams API
- RSA-OAEP in Web Crypto (
generateKey,importKey,encrypt,decrypt) - Custom elements:
ElementInternalsand form-associated callbacks Request.bodyandRequest.textStreamHTMLFormElement.reset, form numeric and named index,form.fieldHTMLTableElement.rows,HTMLSelectElement.remove(index),select.lengthsettertextarea.type,fieldset.type,output.type;HTMLMeterElementaccessorsGlobalEventHandlersattributes onWindowandDocument; document named index- Performance secondary buffer;
performance.timeOriginrelative to the Unix epoch ConsoleandCSSare now proper namespaces; more missing namespace methods
Forms / input
- Implicit submit on Enter; improved form submission; GET submissions replace the action's query
- Fire
changewhen typed text is committed by blur or Enter - Ctrl+A selects the whole value in text fields
- All text edits go through one gated path; better
contenteditabledetection - Single-contact touch for CDP, testdriver and BiDi
- One WebDriver key table shared by BiDi, testdriver and
press - Click press/release sequences shared across input paths and matched to Chrome
- Keydown default actions run only for trusted events
- Range and color inputs get their default value;
input.valuereflects to the attribute in default modes - Skip inputs with an empty name;
:checkedapplies to options; option text strips and collapses whitespace
Web API behavior / fixes
fetchresolves after headers are received; an abort signal aborts a fetch- XHR response header compliance; improved data-URL parsing
- Exceptions from timers, animation frames,
on*handlers, observers and microtasks go toreportError on*handler attributes behave like any other event listenerdocument.openresets loaded frame state; severaldocument.closecrash fixes- Fire
popstateon a fragment navigation; history traverses within a document by entry - Each
Windowgets its ownHistory;LocationURLs resolve against the calling document - Dynamic
<base>updates the document base URL iframereflects and reacts tosrc; sandbox token queries; iframe removal cleanupreplaceChildrenadopts nodes from another document- Classic scripts are decoded with their charset
- Timers accept any value; negative delays clamp to zero
IntersectionObserveronly intersects connected targets- Fix custom element upgrade ordering during fragment parsing; undefined custom elements use the
HTMLElementprototype
CSS / selectors / rendering
- Computed style reports initial values and a resolved
font-size; padding, margin and border widths default to0px text-transformapplied ininnerTextand resolved ingetComputedStylerevertandrevert-layertreated likeinherit- Decode fetched stylesheets; fix tokenizer exponent and hyphen-escape bugs; external stylesheet cap raised to 4 MiB
- Hit testing honors
pointer-events:noneandvisibility:hidden - Visibility inheritance matches Chromium in styles and the AX tree
- Hide a
[popover]that is not showing - Block-level flex and grid containers no longer grow with their items
- Selectors:
:valid/:invalidon every validity constraint,:read-write/:read-onlyper HTML, case-insensitive attribute values, type selectors on XML and foreign elements, pseudo-elements accepted
CDP (Chrome DevTools Protocol)
- Pause requests at the
Fetchresponse stage - Start of the
Debuggerdomain - Emit
Runtime.exceptionThrownfor uncaught page exceptions Page.navigatedWithinDocumentfor fragment navigations and traversals;Target.targetInfoChangedon URL/title change- Honor
Page.navigatereferrer/referrerPolicyand client target filters insetAutoAttach - Keyboard input reaches the focused element inside an iframe;
rawKeyDowndispatches keydown - AX tree:
depthparam, properties written closer to Chrome, accepted without params - Accept the cookie fields Chrome accepts, so
deleteCookieworks
WebDriver / BiDi
- BiDi
browser.getClientWindow - WebDriver window close
- CDP and BiDi cookies built through one Chrome-checked constructor
HTTP / Networking
- Update libcurl to 8.23.0; enable zstd
- Check more HTTP caching headers
- Cookies: keep a session cookie set with
expires -1; accept a UTC zone inexpires --http-curvesto set TLS key exchange groups;--http-debugfor libcurl verbose outputserveaccepts the--advertise-hostname as the WebSocketHost
MCP / agent / tools
- MCP runs each HTTP session on its own thread; idle sessions can be reaped with
--http-session-timeout(off by default) - Agent:
--tracewrites one JSON line per step;--trace-resultsadds tool result text - Agent: tells the model today's date, flags 4xx/5xx navigations, drops stale tool results
- Tree tool:
maxBytesbudget with[more]markers; iframes listed with their URL - Search drops results the browser would block
- Telemetry records tool calls and the MCP client name
Dump / markdown / PDF
- PDF output includes the actual text
--render-fontadds fonts for characters the bundled DejaVu fonts lack (e.g. CJK)- More aggressive clutter stripping;
<template>contents serialized; fenced code blocks keep their language
CLI
completioncommand prints shell completion for bash, fish and zsh
Performance / memory
- Return freed malloc memory to the OS when a connection closes (glibc)
- Cache computed ancestry values and the root node during parse
- Faster
Node.getDocument, owner frame lookup and anchor query matching - Backtrack limit on user-supplied regex
- Limit V8
ArrayBufferallocation to 4 GB; don't copyReadableStreamchunks into the page arena
Stability fixes
- Fix UAF in
MutationObserver - Refuse native calls when terminating; run microtasks only at call depth 0
- Commit an error document when a root navigation fails
- Re-implement
__clear_cacheon Linux arm64 to work around a Zig bug - Log the script that ran out of JS heap
Build / CI
- Upgrade to Zig 0.17
- Unit tests run across parallel processes (about 3x faster)
- Nightly builds strip debug symbols
1.0.0
Behavior changes
getComputedStyleresults are now read-only.- The
"en"language fallback was removed. Language now comes from--locale. - Redirects that switch to GET now drop body headers.
WebDriver
- Classic HTTP WebDriver, built out into a usable driver
- Session management;
navigate; back/forward;execute - Element endpoints; input (click, clear, sendKeys); cookie and viewport endpoints
- Higher default/max HTTP limits
CORS
- CORS is now enforced by default. Cross-origin fetch/XHR requests that fail a CORS check are blocked. Turn it off with
--disable-features cors. The old--experimental-features corsflag is gone. - CORS store with an entry limit (
--cors-store-entry-limit, default 1000) - Fetch referrer policy + CorsGate referrer checking
Sec-Fetch-SiteandSec-Fetch-Moderequest headers- Limit redirects that carry credentials
New Web APIs
WebAssembly.compileStreamingandinstantiateStreaming- Sanitizer API (initial)
TextEncoder.encodeIntoelement.requestFullscreen(mostly a stub)inertproperty;iframesandboxsetterimgsrcsetsupport; report natural dimensions for fetched imagesnew Option()and the legacy constructor APIDOMTokenListsetters; more accuratewindow.isSecureContext- Experimental
ServiceWorker(behind--experimental-features serviceworker) withCache/CacheStorage
Web API behavior / fixes
<template>content handling- Custom element callbacks may move the element during parse
request.clone()clones headers; correct fetch/response handling of null bodies- XHR/fetch report the status reason from the server;
TypeErroron XHRsend(SharedArrayBuffer) input.select()no longer throws for email/number;element.focus()only on focusable elements- Correct error on a wrong method; guard headers
- Validate the XML declaration
- Avoid spurious mutations for unchanged CSS declarations
CSS / rendering
- Split the style cascade into property groups; honor
!importanton tracked stylesheet properties - Resolve width/height from stylesheet rules; give the document a height and clamp viewport scroll to it
- Measure wrapped text for an element's content height
- Resolve scroll containers through the style cascade; unify wheel dispatch; clamp scroll offsets and latch a wheel to one container
CDP (Chrome DevTools Protocol)
- Optimize
Network.getResponseBody DOM.getFrameOwnerreturns the owning<iframe>; nodes carry aframeId- Answer inspector commands on the session that sent them; echo the
sessionIdin browser-level replies - Notify target closure when disposing browser contexts; report the initial
about:blankas loaded window.devicePixelRatiofrom the viewport scale; char text insertion- Move a kept isolated-world context onto the navigated origin
HTTP / Networking
- Improve caching; add
x-frame-optionssupport - Keep connections healthy: don't re-use connections likely in a bad state
- Lowercase response headers; clamp the response status range and report the server's reason phrase
- Add headers to the sync-request path
- Accept Netscape cookie format in
--cookie; report invalid same-site over CDP - Generate an appropriate error on a bot challenge
Agent / tools
- Add OpenRouter provider;
lightpanda run -reads a script from stdin - Report the HTTP status of a navigation; wait for networkidle after an action-triggered navigation
findElementmatches names by/regex/- MCP carries the navigation outcome as
structuredContent - REPL output fixes and simpler command dispatch
CLI / ops
- Report usage errors once, accept
-h, show tips only on a terminal; scale the "did you mean" distance with input length - Respect
NO_COLORand disable colors when stderr is not a tty - Per-page context logs; many warn/err logs downgraded to debug
- Log the stalled page and JS stack on watchdog termination
- Record Linux fatal signals without blocking on stderr
Dependencies
- V8 updated to 15.5.35.13
- BoringSSL, nghttp2 1.70.0, PCRE2 10.49, refreshed public suffix list
Performance / memory
- Replace the slab allocator; set
M_MMAP_THRESHOLDto 128K on Linux - Convert recursive walks to iterative: XPath, SemanticTree/AXNode, markdown, screenshot, dump
- Share one PCRE2 wrapper across the regex paths
- Faster V8 background-job scheduling and task wakeup
- Track and free abandoned html5ever parsers; drop the allocation for the default sanitizer
Stability fixes
- Crash fixes: node cycles when the parser reparents moved nodes, a scrolling stack overflow, a double-free in IndexedDB, a rare import crash
- Stop load events on a document superseded by navigation
- V8 always detaches the global
0.4.1
CORS (experimental)
CORS is off by default. Enable it with --experimental-features cors.
- CORS implementation: obey cross-origin checks on fetch/XHR instead of allowing them unconditionally
Originheader + request header validation- XHR changes for the CORS WPT tests
IndexedDB
- WPT conformance pass
setNameonIDBObjectStoreandIDBIndexnextunique/prevuniquecursor directions- Keep the
upgradeneededevent alive past dispatch; better error handling - Fix use-after-free reading
txn._dbafterreleaseReffrees it
New Web APIs
CountQueuingStrategyandByteLengthQueuingStrategyresource-timing;Performanceis now anEventTargetwindow.stop()img.decode()navigator.sendBeaconreturnstrueHeaders.getSetCookie,customElements.getName,Element.partHTMLInputElementvalueAsNumber,valueAsDate,stepUp/stepDown,showPickerSVGGraphicsElement.getCTMandgetScreenCTMcanvasmeasureTextand the drawing methods chart libraries probematchMediachange events and realaddListener/removeListener- Reflect
HTMLElement.contentEditable - Basic support for CSS custom properties
Forms / input
- Text entry: move the cursor on caret keys and to the end on value set; clamp selections against the current value
- Trusted
beforeinputis cancelable - A disabled
fieldsetdisables its controls' activation and validation option.selected = truedeselects its siblings in a single select- Fix select value assignment with no matching option
Custom elements
- Upgrade autonomous custom-element clones in place
- Don't upgrade custom elements in a windowless document
- Skip null nodes when a create callback fails
CSS / rendering / performance
- Memoize
StyleManagervisibility per element - Append inserted rules to the buckets instead of rebuilding
- Materialize inline styles where layout reads them
--strip-modegainsshellandclutteroptions- Faster
nth-*selectors, class matching, attribute lookup, and pseudo-class parsing
Ad blocker
- Run
/regex/filters with PCRE2 - Request engine
Protocols
- WebDriver: HTTP WebDriver session management
- CDP:
DOM.focus; honorrunImmediately,screenWidth/screenHeight,browserContextId - CDP: request interception patterns; a context per isolated world per frame
- CDP: wheel events scroll the viewport unless over a scroll container
- CDP: fix message lifetimes and console argument serialization; remove a terminate/disconnect race
HTTP / Networking
- Keep connections alive across navigations; better redirect handling; timeout tweaks
- Enable
CURLOPT_PIPEWAITon every easy handle - Update curl to 8.22.0
- Cookies: accept
Secureand__Host-on loopback origins; apply theSameSite=Laxexception only on safe methods; compute site-for-cookies from a frame's ancestor chain - Guard WebSocket message-length parsing against integer overflow
- Fix drive-letter lookalike URL segments on non-file schemes
CLI / tools
--localeand--timezone, with language signals derived from one value- Suggest the closest flag or command on a typo
notelog level can be silenced; log CLI tips- Scroll the nearest scroll container from the
scrolltool - Click dispatches a full pointer/mouse sequence, not a bare click event
- Agent: route REPL output per tool and align page tables of any size
Stability / memory
- Crash fixes:
TryCatchcopied by value,history.state/Navigation.currentEntry, V8 re-entry on an unhandled promise - Fix
Notificationuse-after-free - Disconnect runaway intersection observers; raise timer caps
- Leak fixes: robot store, JS terminated during MutationObserver/IntersectionObserver delivery, cloned HTTP responses, V8 backing store
- V8: notify isolate shutdown, restore the initial heap limit, avoid rearming heap termination during teardown
- Disarm the watchdog before protocol teardown
0.4.0
Breaking changes
Iframes and workers no longer load by default. This makes resource loading
consistent: nothing loads unless you ask for it.
- Restore the old behavior with
--load-resources iframeand--load-resources worker. - External stylesheets stay off by default too: use
--load-resources stylesheet.
Deprecated flags (they still work, but now print a warning):
--disable_subframes→ iframes are off by default; use--load-resources iframeto turn them on.--disable_workers→ workers are off by default; use--load-resources workerto turn them on.--enable_external_stylesheets→ use--load-resources stylesheet.--log-filter-scopes→ renamed to--log-filter.- Comma-separated list values (e.g.
--adblock-lists a,b) → pass the option multiple times instead (--adblock-lists a --adblock-lists b). Affects--strip-mode,--adblock-lists,--block-cidrs,--block-urls.
Protocols
- WebDriver BiDi support (with a
[classic]WebDriver start); protocol selection via CLI; both CDP and BiDi can be served on the same port - WebDriver: better keyboard and mouse handling
New Web APIs
URLPatternnavigator.geolocation+Emulation.setGeolocationOverrideWorkerNavigatorcanvas.toDataURL/toBlob(returns a 1x1 PNG)HTMLElement.draggableIDL attribute- Many element getters/setters added and reworked; improved XPath support
New features
- Screenshot support (
--dump png,screenshottool): renders the page's markdown - PDF support (
--dump pdf,Page.printToPDF): renders the page's markdown - Ad blocker: EasyList parsing (initial)
--load-resourceswith animageparameter (mimics image fetches)--http-headerto send headers on every HTTP request--http-version 1.1/autoflag- Optional HTTP rate limit
exasearch engine support;Keenableengine with a keyless option
Web API behavior / fixes
searchParamskeeps a linkedURLin sync;URLSearchParamsiterator and percent-escape fixesFormDataencodingFileReaderis now asynchronous with proper text decoding- Blob / File conformance; correct content-type for blobs;
application/octet-streamMIME - XHR: sync requests, Blob response type
- Edit-key support in
input/textarea; improved hover events - Prevent
click()from triggeringclick() - Re-parse
element.stylewhen thestyleattribute changes - Promise-returning operations reject (not throw) on a bad receiver
- Reject XML documents that are not well-formed
DOMParsercaptures the owning frame for the correct URL- Handle immediate
meta refreshnavigation
Rendering / CSS
clientHeight/clientWidthreturn the viewport for the bodydevice-width/device-heightmedia features- Compare visibility and CSS keyword values case-insensitively
- Reuse storage for updated property values
- Markdown dump separates flex and grid items; skips hidden elements
HTTP / Networking
- Strip
Authorizationon cross-origin redirects - Send
Sec-Ch-Ua-Full-Version-Listheader - Better
robots.txtstatus handling - Fix WebSocket data send on a small buffer
- Guarantee a single-outcome callback contract for
Transfer
CDP (Chrome DevTools Protocol)
- Answer unknown methods with
-32601, like Chrome - Enforce
Network.enablelimits - Accept the emulation and setup calls drivers send at context creation
- Pass more
Runtimemethods through to the inspector; fill allDOM.getBoxModelquads obeyRobotsadded toLP.configureCDP
MCP / tools
- Negotiate the protocol version on initialize; enforce HTTP conditions; close the connection after
keep_alive=false - Add title and annotations to
tools/list; logfmt is now a config default - Add
maxBytesandstripto thehtmltool;--selector/--max-bytesforfetch - Interactive/links/markdown: skip hidden elements, take roles and names from the AXNode, dedup links by href
Agent
- List all agent providers and gateway examples in the README
- Fix agent history in JS mode
Stability / memory
- Disconnect runaway mutation observers; drop async module completions after termination
- Fix double-release and other edge-case memory issues
- Fix UAF when a
PerformanceObserverdisconnects in its callback - Fix arena leak on page shutdown with live animations
- Several crash fixes: null deref on cross-context
ReadableStream, unsafe element cast, label click Node.flagsfor lookup short-circuit (perf)
Build
- Simplify
build.zig; pindev_fastto the host glibc; use an orderfile on Linux CI builds -Ddev_fastspeeds up Linux debug builds: shared V8 + Zig's self-hosted backend (instead of LLVM)
0.3.7
New Web APIs
Scheduler(window and worker)- Full SVG DOM: geometry, structural elements, text DOM, resource elements, live collections, live scalar values
Element/ShadowRootgetHTMLRequest#formDataandResponse#formDataURL.isSameOriginiframesrcdocsupportElement.webkitMatchesSelector(alias ofmatches)
Web API behavior / fixes
- Custom element creation and reactions now pierce the Shadow DOM
- Report custom-element errors via
window.reportError - Iterators given to types with an indexed property
- Track node relocation across shadow roots; better events from a
ShadowRoot getComputedStyleimprovements with pseudo-elements- Console conformance improvements
- Forms: include
optgroupchildren in a select's list of options - Fix
scriptsetAttributesrc; fix script load/error events - Increase max timer count
- Collection bug fixes; keep ascending live-collection reads linear
- Fix potential UAF when an option's value is set programmatically
Rendering / CSS
- CSS
width/heightare now children-content aware - Fall back to
contentWidthwhenclientWidthis not explicit
HTTP / Networking
- Enforce
User-AgentandSec-Ch-Uaheader restrictions; improve header overwrite/enforcement - Rework how
HttpClientheaders work - Start of a correct referrer policy; recalculate
Refereron each redirect - Single-flight request coalescing
fetchdefaults--wait-untiltoload- Redirect even on a missing
close_notify - Buffer a closed
ReadableStreambody for afetchPOST - Rework
Connection.upgradewithheader_parser
Cache
- SQLite cache backend
- HTTP cache entry limit; cache maintenance moved to startup and
browser.deinit
CDP (Chrome DevTools Protocol)
Originand additionalHostheader validation for CDP connections- Fall back to loopback when the
/json/versionbind host is a wildcard - Add request post data; send request-information notifications on redirect
- Add
/json/protocolendpoint - Split
active_connsfromactive_threads - Avoid creating duplicate isolated worlds
- Fix Playwright redirect routing chains and auxiliary CDP session interception
- Mask URL fields from crash reports; remove
Target.sendMessageToTargetsession_idassertion
Agent / tools
- Support subscription auth via Codex
- Add Brave search +
/searchEnginemetacommand - Treat
backendNodeId0 as omitted; add recovery hints to errors; surface unknown tool names in-band - Reduce tool output cap to 64KB (except for
extract) goto: optionalwaitUntil+ DOMContentLoaded-gated selector waits
Memory efficiency
- Switch
Node,Element, andEventTarget_typefields to a bare tag - Remove the
_protofield from mostNodetypes - Optimize the node child list; rework
Stringto bealign(8) - Improve
ArenaPoolusage; move morecall_arenas tolocal_arenas - Prefer
ensureTotalCapacityPrecise; improve blob memory efficiency - Reduce V8 memory-pressure notifications; add JS memory gauge and arena allocation metrics
Stability fixes
- Capture and propagate
ExecutionTerminated; clear the V8 terminating state after a terminated microtask checkpoint - Fix page double-free on navigate failure (UAF)
- Propagate worker-thread failures to the exit code
Build / dev
-dev_fastbuild flag; on by default on Linux; support for a pre-built shared library- Replace
@cImportwith build-systemtranslateC - Replace the deprecated
MemoryPoolwith the managed memory pool - Rework the scheduler; runner advances idle notifications outside the wait-condition loop
- Add
lp.IS_DEBUG/lp.IS_TEST; more consistent clock/timestamp use
0.3.6
New Web APIs
- Live SVG scalar values; SVG prototype chains derived
Float16Arrayexposed (V8)Disposeevent forNavigationHistoryEntry
Web API behavior / fixes
XMLHttpRequestuses the XML parser for XML content-type responses; fix XHR response handlingFormDataappend blob fix- Derive
scrollWidth/scrollHeightfrom element content - Improved
ResizeObserver(behavior + performance) - On script error, trigger
window.reportError; fix segfault onwindow.reportError - Forms: close the ancestor dialog on
method=dialogsubmission Blobshared per origin
CSS / rendering
- Respect
@layerpriority in the cascade
CDP (Chrome DevTools Protocol)
- Complete
Networkevents and include worker requests - Per-CDP control for
Network.setCacheDisabled - Expose child-frame metadata; preserve node IDs across child-frame navigation
- Ignore duplicate
enablecalls - Sanitize non-UTF-8 values
- Improved dead-peer detection
HTTP / Networking
- Support loading custom CAs (
--ca-cert,--ca-path) - Cookie store; cookie improvements
- Request blocking fixes
- Improved
robots.txtcorrectness - Never cache the top-level root page
iframeloadsabout:blankon an un-parsable URL- WebSocket: use a posix shim for shutdown; improved WPT results and reduced flakiness
Performance / memory
- Avoid a tight tick loop before pages load; don't poll when a message is dispatched
- Improve Runner tick signaling on macrotask-only waits
- Reduce GC hint frequency
- Inline finalizer callbacks
- Set a per-browser memory limit (instead of per-process) for WPT
Stability fixes
- Poll the terminate state during large HTML parsing; interrupt nested script waits during teardown
- Make refcounts
u32to prevent overflow - Fix CLI help pager broken by the failing allocator
CLI / Ops
- New
runcommand for script replay - Route script console output through an optional sink
Build / CI
- Zig 0.16 upgrade; Nix flake updated for Zig 0.16
- Key the prebuilt-V8 cache on the zig-v8 tag
- Pin GitHub Actions to commit SHAs; add plumber to watch workflow security