Перейти к содержанию

Объявление файла

Вы можете сказать TypeScript, что пытаетесь описать код, из другого места (например, написанный на JavaScript/CoffeeScript/Среда выполнения, такая как браузер или Node.js), с помощью ключевого слова declare. В качестве небольшого примера:

1
foo = 123; // Ошибка: `foo` не определен

vs.

1
2
declare var foo: any;
foo = 123; // разрешается

У вас есть возможность поместить эти объявления в файл .ts либо в файл .d.ts. Мы настоятельно рекомендуем, чтобы в ваших реальных проектах вы использовали отдельный .d.ts (начните с одного и назовите что-то вроде global.d.ts или vendor.d.ts).

Если файл имеет расширение .d.ts, то к каждому определению корневого уровня должно быть добавлено ключевое слово declare. Это поясняет автору, что не будет кода, генерируемого TypeScript. Автор должен убедиться, что заявленный элемент будет существовать во время выполнения.

  • Объявления среды - это обещание, которое вы даете компилятору. Если они не существуют во время выполнения, и вы пытаетесь их использовать, все будет сломано без предупреждения.
  • Объявления среды похожи на документы. Если источник изменился, документы должны быть обновлены. Таким образом, у вас могут быть новые поведения, которые работают во время выполнения, но никто не обновляет объявления среды, и, следовательно, вы получаете ошибки компилятора.

Комментарии