ts blank space ดาวน์โหลด - ts blank space ดาวน์โหลดซอร์สโค้ด

ts blank space

ซอร์สโค้ดอื่น ๆ

v0.4.3

ดาวน์โหลด

'ts-blank-space' เป็นโลโก้ 'ts' อยู่ใน TypeScript สีน้ำเงิน และ 'ช่องว่าง' อยู่ใน JavaScript สีส้ม

ตัวเปลื้องประเภท JavaScript ขนาดเล็ก รวดเร็ว และบริสุทธิ์ที่ใช้ตัวแยกวิเคราะห์ TypeScript อย่างเป็นทางการ

TypeScript เข้าไปอยู่ใน:

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

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

JavaScript + space ออกมา:

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

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

ลองเล่นในสนามเด็กเล่นดูสิ

เหตุผล

ประโยชน์ของห้องสมุดนี้คือ:

มันรวดเร็ว
- ดูโฟลเดอร์ ./perf สำหรับการวัดประสิทธิภาพแบบไมโคร
  - ช้ากว่าหม้อแปลงแบบมัลติเธรดดั้งเดิมเพียง 4 เท่า
  - เร็วที่สุดเมื่อเทียบกับคนที่ไม่ใช่เจ้าของภาษา (JavaScript หรือ Wasm)
- ไม่มีการสร้างโค้ด JavaScript ใหม่ แต่จะนำส่วนของสตริงต้นฉบับที่มีอยู่กลับมาใช้ใหม่แทน
- โดยเฉพาะอย่างยิ่งหากโปรแกรมของคุณสร้างออบเจ็กต์ TypeScript SourceFile อยู่แล้ว เนื่องจากสามารถนำกลับมาใช้ใหม่ได้ และการสร้าง AST นั้นเป็นส่วนที่ใช้เวลานานที่สุด
รันไทม์จาวาสคริปต์ 100%
- ไม่มีวอสม์
- ไม่มีส่วนเสริมดั้งเดิม
- ไม่มีกระบวนการลูก
มันมีขนาดเล็ก
- โค้ดประมาณ 700 บรรทัดและการขึ้นต่อกันหนึ่งรายการ ( TypeScript )
- เมื่อทำเพียงเล็กน้อย โค้ดก็ควรดูแลรักษาได้ง่าย
มอบหมายการแยกวิเคราะห์ให้กับตัวแยกวิเคราะห์ TypeScript อย่างเป็นทางการ
ไม่จำเป็นต้องประมวลผล SourceMap เพิ่มเติม ดู "SourceMaps ของฉันอยู่ที่ไหน"

รองรับไวยากรณ์ TypeScript บางส่วนเท่านั้น (ดูไวยากรณ์ที่ไม่รองรับ) นอกจากนี้ยังไม่มีการปรับระดับลง JavaScript จะถูกเก็บรักษาไว้ตามที่เป็นอยู่

สารบัญ

กำลังติดตั้ง
เอพีไอ
ตัวโหลด Node.js
SourceMaps
รายละเอียดการดำเนินการ
ไวยากรณ์ที่ไม่สนับสนุน
tsconfig.json
ทีเอสเอ็กซ์/เจเอสเอ็กซ์
เอาต์พุต 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 แสดง hook ตัวโหลดโมดูล 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

SourceMaps ของฉันอยู่ที่ไหน

เนื่องจาก 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 ,
}

ทีเอสเอ็กซ์/เจเอสเอ็กซ์

อินพุต .tsx จะสร้างเอาต์พุต .jsx ส่วน JSX จะไม่ถูกแปลง แต่จะถูกเก็บไว้ในเอาต์พุตแทน

ตามค่าเริ่มต้น ts-blank-space จะแยกวิเคราะห์ไฟล์โดยถือว่า . .ts หากไฟล์ต้นฉบับมีไวยากรณ์ JSX การแยกวิเคราะห์ควรทำด้วยตนเอง มีตัวอย่าง TSX ใน valid.test.ts

 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 ) ;

รับประกันเอาต์พุต ESM

TypeScript อาจเพิ่ม export {}; หาก import และ export ทั้งหมดถูกลบออก (เนื่องจากเป็น import/export type )

เนื่องจาก ts-blank-space จะลบเฉพาะโค้ดเท่านั้น จึงไม่ดำเนินการนี้ หากต้องการบังคับให้เอาต์พุตมีเครื่องหมายวากยสัมพันธ์ ESM เสมอ คุณสามารถต่อท้าย "export {};" ได้ด้วยตนเอง -