Limitations
editThe library implements most of the web platform, but it is not a complete browser. The main differences are listed below; the WPT coverage gives the reason why each web-platform-test that does not pass fails.
Display and input
No window. The pages are rendered into images: your application takes the screenshots and plays the user with BrowsingContext.Input (see User input). The pinch zoom cannot zoom out below the initial scale of the page, and the scroll methods of the window (
scrollTo()...) do not scroll the zoomed visual viewport. The delegated ink trails (navigator.ink) of the documents of theiframeelements are not drawn in the screenshots of the top-level document, and the scroll performance timing (PerformanceScrollTiming) does not report the scrolls of the scripts nor the scrolls of the zoomed visual viewport.CSS values. A value with more than 1,000 repetitions of a component of its grammar (e.g. more than 1,000 tracks listed in
grid-template-columns, or 1,000 families infont-family) is invalid: the parser backtracks through the repetitions, and a fixed limit keeps the time it takes small and the same on every platform.Layout. The layout engine is internal: it runs when a web API reads the geometry, and its results are read through the web APIs only (CSSOM View, the computed styles, the observers; see Layout and geometry). It does not implement:
- the layout of the content of a page whose inline size differs from the previous page when the page starts inside a line box, a multi-column container, a table row, between the lines of a flex container that wraps, inside a row flex container, or inside a grid row or a grid whose number of columns depends on its width (
auto-fill,auto-fit, a subgrid): it keeps the inline size of the previous page; - the spelling changes at a hyphenation break that replace a character at the start of the next line (the Dutch trema) or that need a dictionary (the triple consonants of the Swedish and Norwegian compound words);
- the hyphenation dictionaries under copyleft licenses (cs, hu, hy, lv);
- the scrolling of a
::scroll-marker-groupthat is a scroll container; - the values of
shape-insideof CSS Shapes 2 (display,outside-shape, an image, a shape box): only the shapes of SVG 2 (basic shapes and references to SVG shape elements) wrap the SVG texts; - in the shaping of the complex scripts, the Myanmar Zawgyi encoding and the Arabic fallback shaping of the Windows-1256 fonts.
- the layout of the content of a page whose inline size differs from the previous page when the page starts inside a line box, a multi-column container, a table row, between the lines of a flex container that wraps, inside a row flex container, or inside a grid row or a grid whose number of columns depends on its width (
SVG
useelements. Theuseelements have no shadow tree of element instances: the referenced content is rendered and hit tested in place, and the events of its instances are dispatched to theuseelement. A click of the user on the instance of a hyperlink (anaelement of the referenced content) follows the referenced hyperlink, whose source element is theuseelement; theShadowAnimationinterface and the:hoverof the instances are not supported.Painting. The core library paints the documents into a display list; a rendering backend produces the pixels. Without a backend, nothing is painted, the images are not decoded and
canvas.getContext("2d")returnsnull. The Imaging backend draws the color glyphs (COLRversions 0 and 1,SVG,sbixandCBDT) with their colors, the canvas layers (beginLayer()) and theCanvasFilterobjects.Float16 canvas storage and transfers are supported, but gradients and intermediate effects use normalized 16-bit colors (see Canvas). As in Blink, the painted boxes and the baselines are snapped to the device pixels and the font metrics are rounded to whole pixels; the layout keeps its fractional geometry.
Images and media
- Images are decoded by the rendering backend. Without a backend, only the natural dimensions of the images are read from their header:
decode()resolves once the image is available, andcreateImageBitmap()rejects the images and the blobs. The Imaging backend decodes PNG (including animated PNG), JPEG (including CMYK), GIF, WebP, AVIF, JPEG XL, BMP and ICO images, with their EXIF orientation and resolution and their color profile. The pages are sRGB: the colors of an image outside of the gamut of sRGB are clipped, and only the Display P3 and half-float canvases keep them (the images whose color profile has lookup tables and thecICPdescriptions other than Display P3 are clipped to sRGB there too). - Audio and video are not decoded. The media elements run on a media backend that your application provides (BrowsingContextOptions.MediaBackend); without it, they have no media. The Media Source Extensions parse the segments with the backend but do not decode the frames. The media controls are not implemented, and Encrypted Media Extensions only implement the Clear Key key system, for the media data of the Media Source Extensions.
- There is no audio or video codec. WebCodecs (
AudioDecoder,VideoDecoder,AudioEncoder,VideoEncoder) andMediaRecorderuse the codecs of a backend that your application provides (BrowsingContextOptions.MediaCodecs, see Audio and video codecs); without it,configure()fails with aNotSupportedError.MediaRecorderrecords WebM streams of VP8 and Opus only.
Network and security
- Nothing is fetched without a document loader, and no script runs without a script engine: the scripts are not fetched and the event handler attributes have no effect. A document parsed with HtmlDocumentParser has no browsing context: no window, no computed style and no event loop, so the mutation observer callbacks are not invoked.
- Storage Access API. The third-party cookies are not blocked unless you block them, and the Storage Access API only gives access to the cookies:
requestStorageAccess(types)and itsStorageAccessHandle(the unpartitioned local storage, IndexedDB, caches... of a third-party frame) are not supported. - Reporting API. The
deprecationandinterventionreports are only generated for the features listed in Network requests (the synchronousXMLHttpRequestrequests of a window,preventDefault()in the listeners that are passive by default), and there is no Crash Reporting API. - Signature-based Subresource Integrity does not support the
signatureattribute of the inline scripts of earlier drafts, nor the'ed25519-…'sources of Content Security Policy. - Compression dictionaries: the
dcbstreams whose dictionary and data exceed the window of the stream are not decoded, and the requests of<link rel="compression-dictionary">have the empty destination (notcompression-dictionary).
Scripting
- The bytes of a shared
WebAssembly.Memoryare allocated for its maximum size, up to 2 GiB minus one page: a shared memory cannot grow beyond. Amemory.atomic.wait32instruction is not interrupted by the limits of the script engine. - JavaScript Promise Integration (
WebAssembly.Suspending,WebAssembly.promising()) is not supported. - The time spent on the styles and the layout is not measured: the long animation frames report a
styleDuration, alayoutDurationand forced style and layout durations of 0, and nopresentationTime. - The scripts run in your process: read Running untrusted pages before you load pages you do not control.
Experimental APIs
The members that implement proposals that no specification defines yet (such as ContainerQueryList.OnChange) have the [Experimental] attribute: using them reports an error with a diagnostic per feature (WEBPLATEXP0003...), which you suppress to use them (<NoWarn>$(NoWarn);WEBPLATEXP0005</NoWarn>). They may change or be removed when the proposal changes.