ScreenOrientation.unlock exceptions description inaccurate

[briantbutton]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/ScreenOrientation/unlock

What specific section or headline is this issue about?

Exceptions

What information was incorrect, unhelpful, or incomplete?

The Exceptions section says, "The promise may be rejected . . ."

However, no promise is returned from this method. AFAIK there are no exceptions, either.

What did you expect to see?

Remove the exceptions, I suppose.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

I love you guys. You do great stuff. I am very glad to make a wee contribution.

MDN metadata

Page report details

• Folder: en-us/web/api/screenorientation/unlock
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/ScreenOrientation/unlock
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/screenorientation/unlock/index.md
• Last commit: 3e543cd
• Document last modified: 2025-06-23T16:41:39.000Z

[Josh-Cena]

My reading from the spec is, this method either synchronously throws an InvalidStateError or SecurityError, or it causes any pending lock() promise to reject with AbortError. You are right that saying "the promise rejects" doesn't make sense.

[briantbutton]

Salud!

Even though it does explicitly say that the 'unlock' method returns 'undefined', the exceptions section looked like that for 'lock', including the mention of a promise. I had just coded up the 'lock', so I did this similarly. I mistakenly coded the 'unlock' with '.then' and '.catch', causing my own exception.