Se você já utilizou TypeScript, provavelmente já ouviu falar da keyword infer
. Ela não é muito comum no dia-a-dia, mas a maioria das bibliotecas mais avançadas em algum momento vai utilizar o infer
para algum tipo de operação.
Para entendermos completamente o infer
, precisamos ter uma noção de como o TypeScript faz a asserção de tipos, e também a hierarquia desses tipos. Eu não vou entrar em detalhes sobre essas informações aqui agora, mas você pode achar vários conteúdos sobre isso na própria documentação do TS.
O infer
é uma keyword que complementa o que chamamos de conditional typing, ou tipos condicionais, que é quanto temos uma inferencia de tipos, seguida de uma condição, por exemplo:
type NonNullable<T> = T extends null | undefined ? never : T
No exemplo anterior, estamos pegando um tipo e verificando se ele é uma extensão ou de null
ou de undefined
, ou seja, tipos que não resolvem para true
, e ai estamos fazendo uma type condition para dizer: "Se o tipo for um desses você retorna never
, caso contrário retorna o próprio tipo".
O infer
permite irmos um pouco mais além do que estamos acostumados nesses modelos. A ideia é que podemos definir uma variável dentro da nossa inferência de tipo que pode ser usada ou retornada, é como se pudéssemos fazer um const tipo = <inferencia>
.
Por exemplo, vamos olhar o utilitário nativo do TS chamado ReturnType
, que pega uma função passada como parâmetro e retorna qual é o tipo do seu retorno:
type ReturnType<T> = T extends (...args: any[]) => infer R ? R : any
O que está acontecendo aqui é uma inferência condicional, já que o infer
não pode ser utilizado fora de condicionais. Primeiro verificamos se o tipo passado estende uma assinatura de função, se sim, vamos jogar o retorno dessa função para uma variável que chamamos de R
, e ai retorná-la.
Outro exemplo, é extrair o retorno de uma promise, como eu comentei aqui nesta thread, se formos pensar em como podemos fazer esse tipo, primeiro temos que verificar se o tipo passado é uma extensão do tipo Promise<T>
, e depois inferir T
para retorná-lo, caso contrário, retornamos never
:
type Unpromise<P> = P extends Promise<infer T> ? T : never
Outros casos de uso
Podemos usar o infer
em uma série de casos, os mais comuns são:
- Obter o primeiro parâmetro de uma função:
type FirstArgument<T> = T extends (first: infer F, ...args: any[]) => any ? F : never
- Obter o tipo de um array
type ArrayType<T> = T extends (infer A)[] ? A : T
- Recursivamente obter o tipo de uma função até achar seu tipo final
type ExtractType<T> = T extends Promise<infer R>
? R
: T extends (...args: any[]) => any
? ExtractType<ReturnType<T>>
: T
Top comments (1)
infelizmente não entendi nada