Editorial review: Add ariaNotify() documentation

[chrisdavidmills]

Description

Chrome 141 adds support for the ariaNotify() method; see https://chromestatus.com/feature/5745430754230272.

This method is currently non-standard, but will be added to the specs imminently; see w3c/aria#2577.

This PR adds:

• A new Document.ariaNotify() page
• A new Element.ariaNotify() page
• A new aria-notify permissions policy directive page
• A mention of it in a few other places, such as the ARIA live regions page.

Setting this to draft for now, as there are still some functionality details to be worked out in tests.

Motivation

Additional details

Related issues and pull requests

[github-actions]

Preview URLs (8 pages)

• /en-US/docs/Web/API/Document/ariaNotify
• /en-US/docs/Web/API/Document
• /en-US/docs/Web/API/Element/ariaNotify
• /en-US/docs/Web/API/Element
• /en-US/docs/Web/Accessibility/ARIA/Guides/Live_regions
• /en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-live
• /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/aria-notify
• /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy

Flaws (6)

Note! 5 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/Document/ariaNotify
Title: Document: ariaNotify() method
Flaw count: 2

• unknown:
  • Error serializing baseline for numeric-seperators: missing field description``
  • Error serializing baseline for single-color-gradients: missing field description``

---

URL: /en-US/docs/Web/API/Element
Title: Element
Flaw count: 1

• macros:
  • Can't resolve /en-US/docs/Web/API/Element/getBoxQuads

---

URL: /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/aria-notify
Title: Permissions-Policy: aria-notify directive
Flaw count: 3

• unknown:
  • No generic content config found
  • no blog root
  • no blog root

(comment last updated: 2025-09-23 13:56:08)

[janewman]

Thanks for putting this together!!

[chrisdavidmills]

Thanks for putting this together!!

@janewman thanks for giving it a look over. I'll move it to the editorial review stage now, but please feel free to chime in if you notice anything that needs attention.