如何在定義文件中定義全局TypeScript變量以便導入？

Question

我有一個外部JS庫全局參數：

function Thing() { ... } 
... 
var thing = new Thing(); 

有一個打字稿定義文件，所以在thing.d.ts：

declare var thing: ThingStatic; 
export default thing; 

export interface ThingStatic { 
    functionOnThing(): ThingFoo; 
} 

export interface ThingFoo { 
    ... and so on 

然後我導入我自己的TS文件這跟：

import thing from 'thing'; 
import {ThingFoo} from 'thing'; 
... 
const x:ThingFoo = thing.functionOnThing(); 

的問題是，transpiles到：

const thing_1 = require("thing"); 
... 
thing_1.default.functionOnThing(); 

這會引發錯誤。我問了一下，在another question和建議是使用：

import * as thing from 'thing'; 

這不能解決問題 - 它給了我在TS thing.default但隨後這是不確定的，一旦transpiled到JS。

我認爲thing.d.ts有什麼問題 - 必須有一種方法來定義可導入的類型化全局參數。

我應該如何編寫thing.d.ts以便正確表示JS，並且不會包含default或其他實際不存在的屬性？

Answer 1

如果使用該庫的唯一方式是通過訪問它的全局變量（而不是將其導入爲節點模塊或amd或umd模塊），那麼最簡單的方法是在頂部沒有任何export s的聲明文件水平。只需聲明一個變量就足夠了。要使用它，必須在編譯打字稿代碼時包含該聲明文件，方法是將其添加到files或include的tsconfig.json中，或者直接在命令行上添加。您還必須在運行時在庫中包含<script>標籤。

實施例：thing.d.ts

declare var thing: ThingStatic; 

declare interface ThingStatic { 
    functionOnThing(): ThingFoo; 
} 

declare interface ThingFoo { 
} 

測試thing.ts

const x:ThingFoo = thing.functionOnThing(); 

可以一起

./node_modules/.bin/tsc test-thing.ts thing.d.ts 

結果被編譯在test-thing.js：

var x = thing.functionOnThing(); 

另請參閱this question關於環境聲明。

注：有模塊裝載機在那裏，允許使用的全局庫，如果他們的模塊，所以它是可以使用的，而不是<script>標籤import聲明，但如何配置這些模塊加載器要做到這一點是另一個，更復雜題。