Missing "lock" method in ScreenOrientation

Nathan Shively-Sanders (@sandersn)

I just updated from 5.1.3 to 5.2.2 and I cannot compile anymore because the "lock" method was removed from the ScreenOrientation interface.

I don't think this is correct.

This is the change https://github.com/microsoft/TypeScript/pull/54725/files#diff-dc0eab937d15e62545da3ed7b4f40ad6b24f15dd88fbc6ceda2bfb4ed8356eb0L20901

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

ping Nathan Shively-Sanders (@sandersn)

thanks

Hmm it seems it's because it falls under the "two major browsers" threshold since Firefox removed it (duh !). However Chrome Android having the majority of the smartphone market wouldn't it make sense to keep it ?

for those who experience this compilation error, you may change to this alternative syntax to bypass the compiler error:

window.screen.orientation['lock']('landscape');

Kagami Sascha Rosylight (@saschanaz)

Kagami Sascha Rosylight (@saschanaz)
I am running into the same problem. This is an obvious regression and should be corrected ASAP.

richso

hello,

I am facing this issue, can't wait for the fix.
the temp solution from richso is not working on my angular project.

Lionel (MC) (@liyokuna)

Lionel (MC) (@liyokuna) As a temporary solution I change the source codes of this lib inside VSCode, so the error stops happening, but every time I update VSCode I need to adjust the source code again, as the source code is inside the VScode folder installed on the my computer.

It's not a recommended solution, but this way VScode stops reporting unnecessary and incorrect errors. This only works for VScode.

Eduardo Mior (@eduardo-mior)

thanks for the answer but Eduardo Mior (@eduardo-mior) i'm on intelli j unfortunately :|

or just add // @ts-ignore before the line

I think the correct way would be adding the now missing interface locally in one of your .ts or .d.ts files:

type OrientationLockType = "any" | "landscape" | "landscape-primary" | "landscape-secondary" | "natural" | "portrait" | "portrait-primary" | "portrait-secondary";
interface ScreenOrientation extends EventTarget {
    lock(orientation: OrientationLockType): Promise<void>;
}

Damien Sorel (@mistic100)

yep did that, Damien Sorel (@mistic100) but i thnik my issue is maybe somewhere else in my ngular project...

Placing that into a d.ts file included in your project will also augment the global types and allow things to work. You definitely do not need to be overwriting any files in VS Code or node_modules to add things to the globals like this.

the main issue is that unlock is there, while lock was removed. even if there is a valid reason to remove lock, it should be consistent, since both of the methods have the same support.

To be fair both method don't have the same support.

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

Holger Jeromin (@HolgerJeromin)

encountered this on vite-react-typescript stack, Holger Jeromin (@HolgerJeromin) 's answer worked perfectly. thanks

Holger Jeromin (@HolgerJeromin)

Holger Jeromin (@HolgerJeromin)'s solution can be shortened by using the already declared OrientationType:

// typescript/lib/lib.dom.d.ts
type OrientationType = "landscape-primary" | "landscape-secondary" | "portrait-primary" | "portrait-secondary";

type OrientationLockType = "any" | "landscape" | "natural" | "portrait" | OrientationType
interface ScreenOrientation extends EventTarget {
  lock(orientation: OrientationLockType): Promise<void>;
}

Seems fixed as of TS 6

Navigation Menu

Repository navigation

Missing "lock" method in ScreenOrientation #1615

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Missing "lock" method in ScreenOrientation #1615

Description

Activity

mistic100 commented on Aug 28, 2023

richso commented on Nov 24, 2023

tsukumijima commented on Dec 31, 2023

liyokuna commented on Jan 18, 2024

eduardo-mior commented on Jan 18, 2024

liyokuna commented on Jan 18, 2024

mistic100 commented on Jan 18, 2024

HolgerJeromin commented on Jan 18, 2024

liyokuna commented on Jan 18, 2024

jakebailey commented on Jan 18, 2024

Knagis commented on Feb 29, 2024

mistic100 commented on Feb 29, 2024

haroldjeshua commented on Nov 19, 2024

rozsazoltan commented on Mar 31, 2025

danielhjacobs commented on Sep 17, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions