Add `dialog.requestClose()`

[lukewarlow]

Specification

https://html.spec.whatwg.org/multipage/interactive-elements.html#dom-dialog-requestclose

Description

The requestClose() method of the HTMLDialogElement interface requests to close the . An optional string may be passed as an argument, updating the returnValue of the dialog.

This method differs from the HTMLDialogElement.close() method by firing a cancel event before firing the close event. This allows authors to prevent the dialog from closing. This method exposes the same behavior as the dialog's internal close watcher.

Documentation

https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/requestClose

Browser support

A new method requeatClose() was recently added to Dialog in Chrome 134 and Safari Tech Preview.

[captainbrosset]

Thanks, Luke, for filing this.

I see there's also api.HTMLDialogElement.closedBy, is this related?

As for where to put these new BCD keys, two options:

• As a whole new feature. Good if developers talk (or are being told) about this as a new capability of the platform.
• As part of the existing closewatcher feature. Good if this isn't a particularly interesting addition to that API on its own, but merely an incremental step.

A third option could be to just add the keys to the existing dialog feature. But I'm not suggesting this because dialog is baseline widely available and very well known by developers.

I lean toward the first option, to make this its own new feature, but curious to hear about possibly adding it to closewatcher, if anyone thinks this is a better idea.

[lukewarlow]

I think closedby should definitely be it's own feature, whether this is included in that or as it's own feature I'm not sure. It's worth noting that they're independent (just happened to ship in chrome at the same time under the same chromestatus).

Safari Tech Preview has requestClose() but not closedby. It's also distinct from close watcher because despite being specced to use close watcher infra it's implementable (as in safari) without close watcher.

[captainbrosset]

Opened #2775 for requestClose.