Array.at() method missing from typescript array type

user_9242225 0
Viewed 988

With:

const myArray = [0,4,2];
myArray.at(-1);

I get the following error under .at

Property 'at' does not exist on type 'number[]'.ts (2339)

What's going on here why doesn't Array.at() work? Do I have to set some sort of browserlist value to let TS know that I want to be able to use this (recently spec'd) feature?

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/at

Here's my tsconfig.json

{
  "compilerOptions": {
    "target": "esnext",
    "useDefineForClassFields": true,
    "module": "esnext",
    "moduleResolution": "node",
    "strict": true,
    "jsx": "preserve",
    "sourceMap": true,
    "resolveJsonModule": true,
    "esModuleInterop": true,
    "lib": ["esnext", "dom"]
  },
  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
}
typescript-typings typescript arrays
2 Answers
user_28872180

It looks like even specifying "lib": "esnext" doesn't do it (playground).

Temporarily, you can do it manually by using your own definitions file to augment the array interface (as described here):¹

declare interface Array<T> {
   at(index: number): T | undefined;
}

That enables it for now (playground).

In very short order (edit: looks like very short order, see jcalz's answer), you should be able to remove that once TypeScript adds it to the ESNext target (and then to the ES2022 target once the spec is officially adopted in June; the proposal is Stage 4 so it will be in the next snapshot).

¹ There's an argument for index?: number rather than index: number, since the spec explicitly handles the case where converting the argument to number results in NaN by saying to use 0 (at uses ToIntegerOrInfinity on the argument, which does the substitution). So per spec, [10].at() returns 10. But hopefully they use the stricter definition of it.

user_1572470
Related