@types.md

@types

Definitely Typed безумовно, є однією з найбільших переваг TypeScript. Спільнота фактично пішла вперед і documented майже 90% найкращих проектів JavaScript.

Це означає, що ви можете використовувати ці проекти в дуже інтерактивний та дослідницький спосіб, не потрібно відкривати документи в окремому вікні та стежити за тим, щоб ви не зробили помилки.

Using @types

Встановлення досить просте, оскільки воно працює поверх npm. Отже, як приклад, ви можете встановити визначення типу дляjquery просто так:

npm install @types/jquery --save-dev

@types підтримує визначення типів global i module.

Global @types

За замовчуванням усі визначення, які підтримують глобальне споживання, включаються автоматично. наприклад дляjquery ви повинні мати можливість просто почати використовувати $ globally у своєму проекті.

Однак для libraries (наприклад jquery) я зазвичай рекомендую використовувати modules:

Module @types

Після інсталяції не потрібна спеціальна конфігурація. Ви просто використовуєте його як модуль, наприклад:

import * as $ from "jquery";

// Use $ at will in this module :)

Controlling Globals

Як видно, наявність визначення, яке автоматично допускає глобальний витік, може бути проблемою для деяких команд. Тож ви можете вибрати explicitly лише введення типів, які мають сенс за допомогою tsconfig.json compilerOptions.types наприклад:

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

Вище показано зразок, де дозволено використовувати лише jquery. Навіть якщо особа встановить інше визначення, наприклад npm install @types/node його глобальні значення (наприклад,process)не просочуватимуться у ваш код, доки ви не додасте їх до опції типів tsconfig.json.