1324375 - Clarify behavior of tabs.remove() Promise when beforeunload blocks removal

Status: RESOLVED WORKSFORME

(Developer Documentation Graveyard :: Add-ons, defect)

Description

[Kestrel]

Documentation states tabs.remove() returns:

> "A Promise that will be fulfilled with no arguments when the tab(s) have been removed."

https://developer.mozilla.org/en-US/Add-ons/WebExtensions/API/tabs/remove

In Firefox 53 the Promise is fulfilled after the beforeunload response even when the user chooses to stay on the page and the tab is not removed.

Possible wording:

> "A Promise that will be fulfilled with no arguments when the tab(s) have been removed 
> or the user chooses to stay on the page(s)."

Note that this differs from Chrome 55 where the callback returns immediately without waiting for the beforeunload response but this means the developer cannot distinguish between user-initiated and programmatic tab closure.

Comment 1

[:shell escalante]

move to dev doc component - we are OK with that wording change proposal