JavaScript 模組 (ES Modules)




你問到了一個非常核心的現代 JavaScript 開發問題！將功能拆分成獨立的 .js 檔案，然後在需要的地方引入，這正是 JavaScript 模組 (ES Modules) 的標準作法。

是的，你完全可以這麼做，而且這是 強烈推薦 的最佳實踐。

步驟 1：準備你的專案檔案結構

首先，為了保持專案整潔，我們建議建立一個 lib 或 vendor 資料夾來存放像 Day.js 這樣的第三方函式庫。

  1. 下載 Day.js : 前往 Day.js 官網 或直接從 CDN 連結下載 dayjs.min.js 檔案。

  2. 建立檔案結構 : 你的專案資料夾看起來應該像這樣：

    your-extension/
    ├── lib/
│   └── dayjs.min.js       <-- 把下載的檔案放在這裡
├── popup.html
├── popup.js               <-- 你的主要邏輯檔案
├── date-formatter.js      <-- 我們要創建的新模組檔案
└── manifest.json

步驟 2：創建你的模組檔案 ( date-formatter.js )

這個檔案的職責很單純：引入 dayjs ，然後擴充 Date.prototype 。

date-formatter.js

JavaScript
// 1. 從你的本地檔案中引入 dayjs 模組
import dayjs from './lib/dayjs.min.js';

// 2. 擴充 Date.prototype (你的原始程式碼)
//    這個檔案不需要 "export" 任何東西，因為它的目的就是執行一次，
//    產生一個「副作用 (side effect)」——也就是修改全域的 Date.prototype。
Date.prototype.toCustomFormatString = function(templateString) {
	const dayjsDate = dayjs(this);
	const formattedString = templateString 
        ? dayjsDate.format(templateString) 
        : dayjsDate.format('YYYY-MM-DD HH:mm:ss');
	return formattedString;	
};

console.log("date-formatter.js 模組已載入並執行。"); // (可選) 用於除錯

步驟 3：在你的主檔案中 ( popup.js ) 使用它

現在，你的 popup.js 只需要「匯入」這個模組，就可以使用它定義好的功能了。

popup.js

JavaScript
// 1. 匯入你的格式化模組
//    我們只需要匯入它來執行它，不需要從中接收任何變數
import './date-formatter.js';

// --- 現在，你可以立即開始使用 toCustomFormatString() 方法了 ---

// 2. 你的應用程式主要邏輯
function initializePopup() {
    const now = new Date();

    const defaultFormat = now.toCustomFormatString();
    console.log("預設格式:", defaultFormat);

    const customFormat = now.toCustomFormatString('YYYY/MM/DD');
    console.log("自訂格式:", customFormat);

    // ... 你其他的 popup 邏輯 ...
}

// 執行
initializePopup();

import './date-formatter.js'; 這行程式碼的意思是：「去執行 date-formatter.js 這個檔案裡的所有程式碼」。一旦它被執行， Date.prototype 就被成功擴充了，所以在 popup.js 的後續程式碼中，所有 Date 物件就都擁有了 .toCustomFormatString() 這個新方法。

步驟 4：【最關鍵的一步】告訴瀏覽器使用模組系統

為了讓 import 語法生效，你必須告訴瀏覽器你的 JavaScript 檔案是 模組 ，而不是傳統的腳本。

對於 popup.js ：

修改你的 popup.html ，在 <script> 標籤中加上 type="module" 。

popup.html

Html
<!DOCTYPE html>
<html>
<head>
    <!-- ... -->
</head>
<body>
    <!-- ... 你的 HTML 內容 ... -->

    <!-- 關鍵！加上 type="module" -->
    <script src="popup.js" type="module"></script>
</body>
</html>

對於 background.js (Service Worker)：

在 Manifest V3 中，Service Worker 預設就支援 ES 模組 。你需要在 manifest.json 中宣告它是模組。

manifest.json

JSON
{
  "manifest_version": 3,
  "name": "我的擴充功能",
  "version": "1.0",
  "background": {
    "service_worker": "background.js",
    "type": "module"  // 告訴 Chrome 這是一個 ES 模組
  },
  "action": {
    "default_popup": "popup.html"
  }
}```
然後在你的 `background.js` 中，你也可以像 `popup.js` 一樣使用 `import`。

### 總結

| 檔案 | 內容 | 目的 |
| :--- | :--- | :--- |
| **`dayjs.min.js`** | 第三方函式庫 | 提供強大的日期格式化功能。 |
| **`date-formatter.js`** | `import dayjs` 並擴充 `Date.prototype` | 創建一個可重用的、專門用來增強 `Date` 物件的模組。 |
| **`popup.js`** | `import './date-formatter.js'` | 你的應用程式主邏輯。匯入模組以啟用新功能，然後使用它。 |
| **`popup.html`** | `<script src="popup.js" type="module">` | **(關鍵)** 告訴瀏覽器以「模組模式」載入你的主腳本。 |

你提出的這個重構想法非常好，它能讓你的程式碼更有組織、更模組化，也更符合現代 JavaScript 的開發標準！

留言

張貼留言

這個網誌中的熱門文章

Offscreen Canvas

 你說得完全正確！這是一個非常經典的效能最佳化思路。如果尖刺框的參數沒有改變，重複計算所有尖刺的路徑和幾何形狀確實是一種浪費。 有幾種方法可以「記憶」或快取你畫的尖刺框，避免不必要的重繪計算： 快取到一個離屏 Canvas (Offscreen Canvas) - 最推薦的方法 原理 ：創建一個與主 Canvas 大小相同（或者只需要能容納尖刺框的大小）的隱藏 Canvas。當尖刺框的參數改變時，或者第一次繪製時，將完整的尖刺框（包括尖刺和中間的填充橢圓）繪製到這個離屏 Canvas 上。 後續繪製 ：在主 Canvas 的每一幀渲染時，如果尖刺框的參數沒有改變，你只需要使用 ctx.drawImage() 將離屏 Canvas 的內容直接繪製到主 Canvas 的目標位置即可。這遠比重新計算和繪製所有尖刺要快得多。 優點 ： 效能提升顯著， drawImage 非常快。 代碼結構清晰，繪製邏輯和快取邏輯分離。 可以快取包含複雜效果（如漸層、陰影等）的圖形。 缺點 ： 需要額外的記憶體來儲存離屏 Canvas。對於大多數尖刺框來說，這通常不是問題。 如果尖刺框需要動態改變大小或位置，離屏 Canvas 的管理（重新創建或調整大小）需要考慮。 快取路徑指令 (Path2D Object) - 適用於路徑本身 原理 ： Path2D 物件可以儲存一系列的 Canvas 路徑指令（ moveTo , lineTo , ellipse , bezierCurveTo 等）。當尖刺框的參數改變時，你構建一個或多個 Path2D 物件來代表尖刺框的各個部分（例如，一個 Path2D 給中心橢圓，另一個給所有尖刺的集合）。 後續繪製 ：如果參數未變，你可以直接使用 ctx.fill(cachedPath) 或 ctx.stroke(cachedPath) 來繪製已儲存的路徑。 優點 ： 比重新執行所有 moveTo/lineTo 更快一些，因為路徑已經編譯好了。 記憶體佔用可能比離屏 Canvas 小。 缺點 ： Path2D 只儲存路徑，不儲存樣式（顏色、線寬等）。你仍然需要在繪製時設定 ctx.fillStyle , ctx.strokeStyle , ctx.lineWidth 。 對於你用 drawTaperedLine 繪製的填充錐形尖刺，...
閱讀完整內容

外部網頁新增 Google 日曆行程(URL模板)

  好的，從外部網頁新增 Google 日曆行程，最常用且最簡單的方法是使用 Google Calendar Event Publisher Guide 提供的 URL 模板 。這種方法不需要複雜的 API 整合或使用者授權流程 (OAuth)，只需要產生一個特殊格式的連結即可。 使用者點擊這個連結後，會被導向到他們自己的 Google 日曆，並看到一個預先填好資訊的新增行程頁面，他們只需要確認並儲存即可。 以下是詳細步驟和說明： 方法：使用 Google 日曆事件發布連結 (URL Template) 基本 URL 結構： https: //www.google.com/calendar/render?action=TEMPLATE 添加參數以預填行程資訊： 在基本 URL 後面加上 & 和 參數名稱=參數值 來指定行程細節。重要的參數包括： text : 行程標題 (必填) 。 範例： &text=團隊會議 dates : 行程開始和結束時間 (必填) 。格式非常重要，必須是 ISO 8601 格式，且 強烈建議使用 UTC (世界標準時間) ，以避免時區混淆。 特定時間格式： YYYYMMDDTHHMMSSZ/YYYYMMDDTHHMMSSZ (Z 表示 UTC) 範例 (2024年7月26日 UTC 下午 2:00 到 3:00)： &dates=20240726T140000Z/20240726T150000Z 全天事件格式： YYYYMMDD/YYYYMMDD (結束日期是 不包含 的那一天的日期，所以通常是開始日期加一天) 範例 (2024年7月27日全天)： &dates=20240727/20240728 location : 行程地點 。 範例： &location=台北101會議室 details : 行程說明或備註 。可以包含換行符號 ( \n )。 範例： &details=討論下一季專案規劃。\n請攜帶筆記型電腦。 sprop : 來源網站資訊 (可選，但建議加入)。 範例： &sprop=name:我的網站名稱&sprop=url:https://www.mywebsite.com add : 邀請的賓客 Email (可選)...
閱讀完整內容

計算 Canvas 文字最大字體

 好的，我將產生一個 HTML 頁面，其中包含一個 Canvas 元素和一個文字輸入框。當你在輸入框中輸入文字並點擊按鈕後，程式碼會自動計算出在指定的 Canvas 寬度內，該文字能夠完整顯示的最大字體大小，並將該字體大小的文字繪製在 Canvas 上。 <html> <head> <title>計算 Canvas 文字最大字體</title> <style> #myCanvas { border: 1px solid black; } </style> </head> <body> <div> <label for="inputText">輸入文字:</label> <input type="text" id="inputText" value="Hello"> </div> <div> <label for="canvasWidth">Canvas 寬度:</label> <input type="number" id="canvasWidth" value="300"> </div> <button id="calculateBtn">計算並繪製</button> <canvas id="myCanvas" width="300" height="100"></canvas> <script> const canvas = document.getElementById('myCanvas'); const ctx = canvas.getContext('2d'); const inputText = document.getElementById('inputText...
閱讀完整內容