ts blank space下載 - ts blank space原始碼下載

ts blank space

其他源碼

v0.4.3

下載

“ts-blank-space”作為標誌。「ts」為 TypeScript 藍色，「blank-space」為 JavaScript 橘色

一個小型、快速、純 JavaScript 類型剝離器，使用官方 TypeScript 解析器。

TypeScript 進入：

 class C < T > extends Array < T > implements I {
//     ^^^              ^^^^^^^^^^^^^^^^
    private field ! : string ;
//  ^^^^^^^      ^^^^^^^^^

    method < T > ( this : T , a ?: string ) : void {
//        ^^^ ^^^^^^^^  ^^^^^^^^^ ^^^^^^
    }
}

JavaScript + 空格就出來了：

 class C    extends Array                 {
//     ^^^              ^^^^^^^^^^^^^^^^
            field         ;
//  ^^^^^^^      ^^^^^^^^^

    method   (         a         )       {
//        ^^^ ^^^^^^^^  ^^^^^^^^^ ^^^^^^
    }
}

在操場上試試看。

基本原理

這個函式庫的好處是：

速度很快
- 請參閱./perf資料夾以取得微基準
  - 只比原生多執行緒轉換器慢 4 倍
  - 與非原生（JavaScript 或 Wasm）相比最快
- 不會產生新的 JavaScript 程式碼；相反，它重新使用現有來源字串的片段
- 如果您的程式已經產生 TypeScript SourceFile對象，則尤其如此，因為它可以重複使用——而生成 AST 是最耗時的部分。
100% JavaScript 運行時
- 沒有瓦斯姆
- 沒有原生插件
- 無子行程
很小
- 大約 700 行程式碼和一個依賴項 ( TypeScript )
- 透過做這麼少的事情，程式碼應該相對容易維護
將解析委託給官方 TypeScript 解析器
不需要額外的SourceMap處理；請參閱“我的 SourceMap 在哪裡？”

並非所有 TypeScript 語法都受支援（請參閱不支援的語法）。也沒有降級； JavaScript 按原樣保留。

內容

安裝中
應用程式介面
Node.js 載入器
原始圖
實施細節
不支援的語法
tsconfig.json
多倫多證券交易所/JSX
ESM輸出
貢獻
執照
行為守則
安全漏洞報告

安裝中

npm install ts-blank-space

應用程式介面

字串到字串

 export default function tsBlankSpace ( ts : string , onError ?: ( node ) => void ) : string ;

 import tsBlankSpace from "ts-blank-space" ;

console . log ( tsBlankSpace ( `let x: string;` ) ) ;
// "let x        ;"

帶上自己的 AST

 export function blankSourceFile ( ts : typescript . SourceFile , onError ?: ( node ) => void ) : string ;

 import ts from "typescript" ;
import { blankSourceFile } from "ts-blank-space" ;

const ast = ts . createSourceFile ( ... ) ;
console . log ( blankSourceFile ( ast ) ) ;

Node.js 載入器

ts-blank-space公開所需的 Node.js 模組載入器掛鉤，以使用ts-blank-space來預處理在評估之前導入的*.ts 。

 # Install (one time):
$ npm install --save-dev ts-blank-space

# Example usage (Node.js >= v18.20):
$ node --import ts-blank-space/register ./path/to/your/file.ts

除了載入*.ts檔案之外，還註冊了一個導入解析器，它捕獲失敗的*.js導入並重新嘗試導入，用.ts替換擴展名。這允許導入路徑選擇.ts或.js具體取決於專案可能需要考慮的其他因素，例如捆綁和包分發。

載入程式假定所有.ts檔案都是 ESM。

我的 SourceMap 在哪裡？

由於輸出中的所有 JavaScript 都位於與原始來源相同的行、列和位元組偏移處，因此在轉換過程中不會遺失任何映射資訊。

它真的只是刪除所有類型註釋嗎？

這裡描述了兩種情況，其中它的作用不僅僅是用空格替換 TypeScript 語法。

ASI（自動分號插入）

為了防止輸出中出現 ASI 問題， ts-blank-space將會加入;到僅類型語句的末尾，並且刪除前導類型註釋時可能會引入 ASI 危險。

範例一 - 僅類型語句

 statementWithNoSemiColon
type Erased = true
( "not calling above statement" )

變成：

 statementWithNoSemiColon
;
( "not calling above statement" ) ;

範例二 - 計算類別欄位/方法

 class C {
    field = 1 /* no ; */
    public [ "computed field not accessing above" ] = 2
}

變成：

 class C {
    field = 1 /* no ; */
    ;      [ "computed field not accessing above" ] = 2
}

引入新行的箭頭函數類型註釋

如果箭頭函數參數周圍的類型註解引入了新行，那麼僅用空格替換它們可能是不正確的。因此，除了刪除類型註解之外，函數參數周圍的(或)也可能會被移動。

範例一 - 多行返回類型：

 let f = ( a : string , b : string ) : Array <
   string
> => [ a , b ] ;

變成：

 let f = ( a        , b

) => [ a , b ] ;

範例二 - 具有多行類型參數的`async` ：

 let f = async <
    T
> ( v : T ) => { } ;

變成：

 let f = async (

  v   ) => { } ;

不支援的語法

TypeScript 的某些部分不受支持，因為它們由於具有運行時語義而無法就地擦除。請參閱 unsupported_syntax.md。

當遇到不支援的語法時， ts-blank-space將呼叫可選的onError回呼並繼續。範例可以在errors.test.ts中看到。

建議的`tsconfig.json`編譯器設定

 {
    // Because JS syntax is emitted as-is
    "target" : "esnext" ,
    // Because class fields are preserved as written which corresponds
    // to 'define' semantics in the ECMAScript specification
    "useDefineForClassFields" : true ,
    // Because imports and exports are preserved as written, only removing the
    // parts which are explicitly annotated with the `type` keyword
    "verbatimModuleSyntax" : true ,
}

多倫多證券交易所/JSX

.tsx輸入將產生.jsx輸出。 JSX 部分不會轉換，而是保留在輸出中。

預設情況下， ts-blank-space將解析假設為.ts檔案。如果原始檔案包含 JSX 語法，則應手動完成解析。 valid.test.ts中有一個 TSX 範例。

 import ts from "typescript" ;
import { blankSourceFile } from "ts-blank-space" ;

...

const tsxSource = ts . createSourceFile ( "input.tsx" , tsxInput , ts . ScriptTarget . ESNext , false , ts . ScriptKind . TSX ) ;
const jsxOutput = blankSourceFile ( tsxSource , onError ) ;