Operador de tipo typeof

O operador de tipo typeof

O JavaScript já tem um operador typeof que você pode usar em um contexto de expressão:

ts
// Prints "string"
console.log(typeof "Hello world");
Try

O TypeScript adiciona um operador typeof que você pode usar em um contexto de tipo para se referir ao tipo de uma variável ou propriedade:

ts
let s = "hello";
let n: typeof s;
let n: string
Try

Isso não é muito útil para tipos básicos, mas combinado com outros operadores de tipo, você pode usar typeof para expressar muitos padrões de forma prática. Como exemplo, vamos começar olhando para o tipo predefinido ReturnType<T>. Ele recebe um tipo de função e produz o tipo de retorno dela:

ts
type Predicate = (x: unknown) => boolean;
type K = ReturnType<Predicate>;
type K = boolean
Try

Se tentarmos usar ReturnType em um nome de função, vemos um erro instrutivo:

ts
function f() {
return { x: 10, y: 3 };
}
type P = ReturnType<f>;
'f' refers to a value, but is being used as a type here. Did you mean 'typeof f'?2749'f' refers to a value, but is being used as a type here. Did you mean 'typeof f'?
Try

Lembre-se de que valores e tipos não são a mesma coisa. Para se referir ao tipo que o valor f tem, usamos typeof:

ts
function f() {
return { x: 10, y: 3 };
}
type P = ReturnType<typeof f>;
type P = { x: number; y: number; }
Try

Limitações

O TypeScript limita intencionalmente os tipos de expressão em que você pode usar typeof.

Mais especificamente, só é válido usar typeof em identificadores (ou seja, nomes de variáveis) ou nas propriedades deles. Isso evita a armadilha confusa de escrever código que você acha que está sendo executado, mas não está:

ts
// Meant to use = ReturnType<typeof msgbox>
let shouldContinue: typeof msgbox("Are you sure you want to continue?");
',' expected.1005',' expected.
Try

The TypeScript docs are an open source project. Help us improve these pages by sending a Pull Request ❤

Contributors to this page:
OTOrta Therox  (4)
UMDFUlisses, Mago do Flutter  (1)
JLJimmy Liao  (1)

Last updated: Nov 16, 2026