Blink's Document Class: Architecture and Lifecycle
Blink2863 Syys 2025

Blink's Document Class: Architecture and Lifecycle

The provided sources offer a comprehensive overview of Blink's Document class, which serves as the core representation of a web page's content within the Chromium browser engine. The Document class is central to the Document Object Model (DOM) and plays a pivotal role in the rendering pipeline, bridging parsed HTML to styling, layout, and JavaScript execution. The text meticulously details the lifecycle of a Document instance, from its initial creation and HTML parsing to the interactive phase, event completion, and eventual detachment and destruction. Furthermore, it explains the Document's intricate integrations with critical systems like the HTML parser, rendering engine (style, layout, paint), and Blink's scheduler, emphasizing its function in managing DOM mutations, dispatching events, and coordinating various observer notifications like MutationObservers, IntersectionObservers, and ResizeObservers. Finally, the sources illuminate the Document's relationship with other essential Blink classes, such as Node, Element, ExecutionContext, Frame, DocumentLifecycle, and LocalDOMWindow, as well as its memory management strategies primarily using the Oilpan garbage collector.

Jaksot(396)

blink::GraphicsContext

blink::GraphicsContext

immediate drawing API that records to a display list. Painters for layout objects use GraphicsContext to “draw”—but in modern Blink those calls get recorded into a display list (PaintRecord) backed by...

10 Loka 202544min

blink::TransformPaintPropertyNode / ClipPaintPropertyNode / EffectPaintPropertyNode / ScrollPaintPropertyNode

blink::TransformPaintPropertyNode / ClipPaintPropertyNode / EffectPaintPropertyNode / ScrollPaintPropertyNode

These are the nodes within those four trees. Every piece of painted content (a “paint chunk”) is associated with a tuple of (Transform, Clip, Effect, Scroll) nodes—its PropertyTreeState. This precisel...

10 Loka 202533min

blink::PaintPropertyTreeBuilder

blink::PaintPropertyTreeBuilder

builds/updates paint property trees.Consumes the layout/fragment data and produces the four paint property trees (Transform, Clip, Effect, Scroll) for the current frame. These trees encode coordinate ...

10 Loka 202547min

blink::PrePaintTreeWalk

blink::PrePaintTreeWalk

cross‑frame pre‑paint traversal. Runs in the InPrePaint lifecycle phase. Walks the entire layout tree starting at the root LocalFrameView, updating paint invalidation state and computing the context n...

10 Loka 202531min

blink::NGPhysicalFragment and friends

blink::NGPhysicalFragment and friends

Layout takes the styled DOM and produces a fragment tree of positioned boxes. In modern Blink this is LayoutNG; the core artifact is NGPhysicalFragment, which stores geometry and is used downstream fo...

10 Loka 202537min

blink::StyleEngine

blink::StyleEngine

style invalidation & resolution (recalc). 
Given DOM/style changes since the last frame, StyleEngine computes updated ComputedStyles, manages active stylesheets/media query state, and marks the right ...

10 Loka 202534min

blink::Document & blink::DocumentLifecycle

blink::Document & blink::DocumentLifecycle

states that gate phases. The document owns the DOM and keeps a DocumentLifecycle state machine that ensures we do things in phase order (style before layout, pre‑paint before paint, etc.). Lifecycle t...

10 Loka 202535min

blink::LocalFrameView

blink::LocalFrameView

orchestrates style → layout → pre‑paint/paint for a frame. This is the workhorse that actually runs lifecycle phases. On a frame tick from WebFrameWidgetImpl, it goes through style recalc, layout (Lay...

9 Loka 202544min