References — bi-05 The Binding Layer
Primary sources first. In-tree Chromium docs beat any external source, including these modules.
Primary
- Web IDL Standard — the interface definition language every web API is written in, and the type-conversion rules that produce the coercions you see from JavaScript.
- Blink IDL documentation — the extended attributes (
[CallWith],[RaisesException],[Reflect]) that appear throughout Blink's.idlfiles. - Blink bindings README
Source
third_party/blink/renderer/bindings/— generated and hand-written gluecore/dom/element.idl— read an IDL file alongside its generated bindingplatform/bindings/script_wrappable.h— the base for anything exposed to JS- V8 embedder API — handles, contexts, isolates, and why
v8::Localexists
V8 itself
- V8 documentation · Design docs
- Hidden classes and inline caches — measured in fe-03 (sibling project): megamorphic access is 1.9×, and 2.9 ns.
- Embedder's guide — handle scopes and the ownership rules that make wrapper lifetime tricky
Related modules
- bi-04 — DOM internals — the C++ objects being wrapped
- bi-06 — Chromium C++ — the language features the bindings use heavily
- fe-03 — Object shapes & JIT (sibling project) — V8's optimisation model, measured and put in perspective
When a claim here proves stale, record it in PROGRESS.md section 7.