jsaddle-dom

DOM library that uses jsaddle to support both GHCJS and GHC

LTS Haskell 24.66:0.9.9.3
Stackage Nightly 2026-11-12:0.10.0.0
Latest on Hackage:0.10.0.0

See all snapshots jsaddle-dom appears in

MIT licensed by Hamish Mackenzie
Maintained by Hamish Mackenzie
This version can be pinned in stack with:jsaddle-dom-0.10.0.0@sha256:a58b6c005d631e030908f8aa9f39bb4786112e2a42497f85b84735acf89d0eb9,167969

Module documentation for 0.10.0.0

Used by 1 package in nightly-2026-11-12(full list with versions):
ghcjs-dom-jsaddle

Documentent Object Model (DOM) functions implemented using jsaddle. It works with both GHCJS and GHC.

Changes

Revision history for jsaddle-dom

0.10.0.0

A major release: the bindings are regenerated from current specifications by a new generator, dom-gen (in the ghcjs-integration repository), replacing domconv-webkit and the WebKitGTK 2.17.2 IDL the 0.9 series was generated from. Expect to update code. ghcjs-dom 0.10 has the same API.

  • Source of truth: the Web IDL of the browser specifications in webref (@webref/idl 3.86.0) and MDN’s browser-compat-data (8.1.8). An interface or member is bound when it ships, unprefixed, in at least two of Chromium, Gecko and WebKit (partial implementations count), or when 0.9 had it and one engine ships it.
  • API-CHANGES-0.10.md lists every change, generated by dom-gen apidiff against 0.9.9.3: 158 interfaces no longer in any specification (mostly WebKit-only), 13 renamed WebGL interfaces, and 2743 removed, 831 moved, 1266 retyped and 13386 new Haskell names.
  • Events are typed from the specifications’ event tables: for example click is a PointerEvent, focus a FocusEvent, input an InputEvent.
  • Interface mixins (ParentNode, GlobalEventHandlers, ARIAMixin, …) are Is* classes with their own modules; requestAnimationFrame is in AnimationFrameProvider and takes a FrameRequestCallback.
  • long long and unsigned long long are Int53 and Word53 (jsaddle 0.9.10, Language.Javascript.JSaddle.Int53): JavaScript Numbers are exact only up to 2^53, and the types have no Num instance so that conversions are explicit.
  • Nullable results are Maybe for numbers too: a null result is now Nothing (0.9 could return Just 0).
  • Dictionaries (MouseEventInit, AddEventListenerOptions, …) have builders, one module each: newPointerEventInit makes an empty object (taking the required members as arguments, as in newRTCIceServer urls), and setX / getX reach each member, inherited ones through the Is* class (MouseEventInit.setClientX works on a PointerEventInit). Getters of optional members return Maybe: an unset member is Nothing.
  • Optional arguments are Maybe and Nothing passes undefined. When a 0.9 operation gained trailing optional arguments, the old arity keeps the old name and the full one is primed (createElement / createElement').
  • Overloads keep their 0.9 names where they match; otherwise they are named by their distinguishing arguments.
  • JSDOM.EventM: the mouse and touch helpers follow the specification types: mouseClientXY, mouseScreenXY and uiLayerXY stay Int (long), while the CSSOM View coordinates (mouseXY, mouseOffsetXY, uiPageXY) and mouseMovementXY are Double, and nullable results are Maybe. uiLayerXY / uiPageXY take any IsMouseEvent, and mouseFromElement / mouseToElement are gone.
  • Hand written modules: only Geolocation, GeolocationPositionError (was PositionError) and XMLHttpRequest remain; the hand written callbacks in JSDOM.Types are now generated.
  • Requires jsaddle >= 0.9.10.