Самостоятельное объявление типа типа в TypeScript

Question

Я хочу использовать модуль assert в browserify/tsify связки. См. https://www.npmjs.com/package/assert и https://github.com/substack/browserify-handbook#builtins и https://nodejs.org/api/assert.html. Короче говоря, это узел-js совместимый модуль assert в браузере, который является браузером встроенного.

Поэтому я добавил @types/assert в мой package.json. Однако модуль декларации не распознается (кажется, глючит). Поэтому я хочу сделать эквивалент node_modules/@types/assert, но за пределами node_modules, так как node_modules не должен находиться в исходном контроле.

Возможно ли это? Если нет, может/должен использовать синтаксис старой школы /// <reference или declare module "assert" или что?

Answer 1

Модули декларации выглядит нормально ко мне на первый взгляд (не тщательный тест), но в любом случае, предполагается, что вы говорите о this library

Создать typings/assert/assert.d.ts каталог/подкаталог/файл, который будет находиться под контролем источника

assert.d.ts должен быть построен как определение внешнего модуля, который экспортирует один символ assert. Содержание почти прямой копией того, что находится в @ типов/утверждают (с необходимыми поправками, вы упомянули)

declare module 'assert' { 

    function assert(value:any, message?:string):void; 

    namespace assert { 

     export function fail(actual?:any, expected?:any, message?:string, operator?:string):void; 

     ... 

    } 

    export = assert 

} 

в tsconfig.json, просто убедитесь, что содержимое каталога typings включен (т.е. не исключается) из сборник.

Answer 2

Чтобы уточнить ответ @Bruno Grieder.

Как tsc находит .d.ts файлы объясняется в https://www.typescriptlang.org/docs/handbook/module-resolution.html

Механизм declare module 'assert' называется Ambient модули:

https://www.typescriptlang.org/docs/handbook/modules.html#ambient-modules