Bug 1441168 - Add some documentation to Window.webidl about DOM modifications within promiseDocumentFlushed callbacks. r=Ehsan

Depends on D14101

Differential Revision: https://phabricator.services.mozilla.com/D16472

--HG--
extra : moz-landing-system : lando
This commit is contained in:
Mike Conley 2019-01-28 06:50:25 +00:00
parent cedc83f7ac
commit f41e30ee01

View File

@ -466,6 +466,11 @@ partial interface Window {
* callback will still be called and the Promise resolved as the window * callback will still be called and the Promise resolved as the window
* tears itself down. * tears itself down.
* *
* The callback _must not modify the DOM for any window in any way_. If it
* does, after finishing executing, the Promise returned by
* promiseDocumentFlushed will reject with
* NS_ERROR_DOM_NO_MODIFICATION_ALLOWED_ERR.
*
* Note that the callback can be called either synchronously or asynchronously * Note that the callback can be called either synchronously or asynchronously
* depending on whether or not flushes are pending: * depending on whether or not flushes are pending:
* *