Typescript
  • Introducão
  • Primeiros Passos
    • Por que TypeScript
  • JavaScript
    • Igualdade
    • Referências
    • Null vs. Undefined
    • this
    • Closure
    • Number
    • Truthy
  • Futuro JavaScript Agora
    • Classes
      • Classes Emit
    • Arrow Functions
    • Rest Parameters
    • let
    • const
    • Destructuring
    • Spread Operator
    • for...of
    • Iterators
    • Template Strings
    • Promise
    • Generators
    • Async Await
  • Project
    • Compilation Context
      • tsconfig.json
      • Which Files?
    • Declaration Spaces
    • Modules
      • File Module Details
      • globals.d.ts
    • Namespaces
    • Dynamic Import Expressions
  • Node.js QuickStart
  • Browser QuickStart
  • TypeScript's Type System
    • JS Migration Guide
    • @types
    • Ambient Declarations
      • Declaration Files
      • Variables
    • Interfaces
    • Enums
    • lib.d.ts
    • Functions
    • Callable
    • Type Assertion
    • Freshness
    • Type Guard
    • Literal Types
    • Readonly
    • Generics
    • Type Inference
    • Type Compatibility
    • Never Type
    • Discriminated Unions
    • Index Signatures
    • Moving Types
    • Exception Handling
    • Mixins
  • JSX
    • React
    • Non React JSX
  • Options
    • noImplicitAny
    • strictNullChecks
  • Errors in TypeScript
    • Interpreting Errors
    • Common Errors
  • NPM
  • Testing
    • Jest
    • Cypress
  • Tools
    • Prettier
    • Husky
    • Changelog
  • TIPs
    • String Based Enums
    • Nominal Typing
    • Stateful Functions
    • Bind is Bad
    • Currying
    • Type Instantiation
    • Lazy Object Literal Initialization
    • Classes are Useful
    • Avoid Export Default
    • Limit Property Setters
    • outFile caution
    • JQuery tips
    • static constructors
    • singleton pattern
    • Function parameters
    • Build Toggles
    • Barrel
    • Create Arrays
    • Typesafe Event Emitter
  • StyleGuide
  • TypeScript Compiler Internals
    • Program
    • AST
      • TIP: Visit Children
      • TIP: SyntaxKind enum
      • Trivia
    • Scanner
    • Parser
      • Parser Functions
    • Binder
      • Binder Functions
      • Binder Declarations
      • Binder Container
      • Binder SymbolTable
      • Binder Error Reporting
    • Checker
      • Checker Diagnostics
      • Checker Error Reporting
    • Emitter
      • Emitter Functions
      • Emitter SourceMaps
    • Contributing
Powered by GitBook
On this page
  • Usando @types
  • Global @types
  • Module @types
  • Controlando as variáveis globais

Was this helpful?

  1. TypeScript's Type System

@types

PreviousJS Migration GuideNextAmbient Declarations

Last updated 6 years ago

Was this helpful?

é um dos maiores pontos fortes do TypeScript. A comunidade foi adiante e documentou a natureza de quase 90% dos principais projetos de JavaScript existentes.

Isso significa que você pode usar esses projetos de uma maneira muito interativa e exploratória, não é necessário ter os documentos abertos em uma janela separada e garantir que você não cometa erros de digitação.

Usando @types

A instalação é bastante simples, porque funciona apenas no topo do npm. Então, como um exemplo, você pode instalar definições de tipo para jquery simplesmente como:

npm install @types/jquery --save-dev

@types suporta as definições de tipo global tanto como module.

Global @types

Por padrão, quaisquer definições que suportam o consumo global são incluídas automaticamente. Por exemplo. Para o jquery, você deve começar a usar $ globalmente em seu projeto.

No entanto, para bibliotecas (como jquery), geralmente recomendo usar módulos:

Module @types

Após a instalação, nenhuma configuração especial é realmente necessária. Você apenas importa-o como um módulo, ex.:

import * as $ from "jquery";

// Use $ à vontade neste módulo 😁

Controlando as variáveis globais

Como pode ser visto, ter uma definição que permita o vazamento global automaticamente pode ser um problema para algumas equipes. Assim, você pode optar por trazer explicitamente apenas os tipos que fazem sentido usando o compilerOptions.types tsconfig.json, por exemplo:

{
    "compilerOptions": {
        "types" : [
            "jquery"
        ]
    }
}

O exemplo acima mostra um exemplo onde somente o jquery poderá ser usado. Mesmo que a pessoa instale outra definição como o npm install @types/node seus globals (por exemplo, ) não irão vazar para o seu código até que você os inclua na opção types no tsconfig.json.

Definitivamente Typed
process