"the iframe must delay the load event of its document"

[domenic]

https://html.spec.whatwg.org/#the-iframe-element:delaying-load-events-mode

the iframe must delay the load event of its document.

"its document" is really quite unclear here. I think it should be replaced by something like "its node document (i.e. the Document containing the iframe element)".

[mkruisselbrink]

Related whenever the spec says "iframe's browsing context" it should probably say "iframe's nested browsing context" to make it explicit which browsing context is being talked about.

[mkruisselbrink]

I'm still not sure if it actually tries to say it should delay the load even of its parent document though... The definition of "delaying load events mode" (https://html.spec.whatwg.org/#delaying-load-events-mode) mentions that it delays the load event of the browsing context container (i.e. the iframe element), it doesn't say anything about delaying the load event of the document containing that container...

[domenic]

I'm fairly certain the web depends on iframe loads delaying the main document's load event, but yeah, that seems like another place to clarify, even if just because the omission can be confusing. (E.g. add "among other things" to that sentence.)

Of course I'm welcome to be shown I'm wrong via tests or similar.

[domenic]

Hey, this got fixed at some point. https://html.spec.whatwg.org/#potentially-delays-the-load-event is now nice and clear.