ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Angular 引入 JavaScript:ES module 與全域 script

任務導覽 TABLE OF CONTENTS

比較 ES module、allowJs、型別提示與全域 scripts,確認 JavaScript 在 Angular 中的載入方式。

適用:Angular原有NgModule專案的設計情境;新程式片段採Angular20 standalone方式,舊版差異另列。先使用與專案相容的Node/TypeScript。

優先使用 module

自己的小函式可轉成TypeScript。若保留JS,建立src/app/greeting.js:

/** @param {string} name */
export function greeting(name) { return `你好 ${name}`; }

在既有tsconfig的compilerOptions加入allowJs: true,將檔案納入編譯;元件使用:

import { greeting } from './greeting.js';
export const example = greeting('Ian');

結果應為你好Ian。allowJs允許JS進TS專案,不會自動建立全域性變數,也不會修復第三方庫缺型別。npm庫優先使用ESM匯入與內建型別/相容@types,保留依賴版本。

全域 script 的舊情境

僅對確實不是module的legacy script,在angular.json對應build.options.scripts加入路徑;需和檔案中window上的名稱一致。TypeScript宣告只告訴型別系統該符號存在,不會載入檔案。先在Network與Console確認實際script載入,再呼叫API。

不得同時以scripts與import載入同一庫以免重複例項。手動createElement(script)是另一種動態載入設計,需處理load/error、CSP與來源可信性,不能用來繞過建置配置。

SSR 與維護

window/document不存在於Node SSR,browser-only庫要限制在瀏覽器流程初始化,並於元件解除安裝清理監聽。全域性指令碼難以tree-shake與測試,逐步包裝成明確service或module;先保留原行為測試再替換。

確認方式是build成功、問候輸出符合預期且script只載入一次。原合併衝突標記與重複compilerOptions範本已經移除。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文