Chuyển đến nội dung
MINH VO Ghi chép từ công việc
của một kỹ sư tại Việt Nam
Cơ bản12 phút đọc

ES modules có một đồ thị tải

Theo dõi một module dùng chung qua liên kết trực tiếp, số đo tải HTTP, lỗi khởi tạo và danh tính URL bằng ví dụ đầy đủ với nút HTML gốc.

Các bố cục trình duyệt bằng giấy màu ô liu và be, thể hiện trang trên máy tính và màn hình di động hẹp hơn

Nếu bạn đã biết gắn hàm xử lý sự kiện click và tách một hàm sang tệp khác, ES modules đặt ra câu hỏi tiếp theo: những tệp nào phải khởi tạo xong trước khi hàm xử lý này có thể tồn tại? Một câu lệnh import mô tả quan hệ phụ thuộc. Nó còn tạo liên kết tới các giá trị được module khác export, với vòng đời có thể dài hơn một giao diện cụ thể.

Ví dụ này dùng module trình duyệt thông thường qua HTTP, không qua bundler. Hai tệp cùng import một bộ đếm. Ta sẽ phân biệt giá trị đang thay đổi với một số đã chép, đo đồ thị tải và chủ động làm hỏng từng giai đoạn. Hướng dẫn module của MDN cung cấp nền tảng rộng hơn về ngôn ngữ và yêu cầu của trình duyệt.

Một bộ đếm, hai nơi import

Lưu ba tệp dưới đây trong thư mục modules. identity là một đối tượng rỗng đã được đóng băng, chỉ dùng làm dấu nhận diện theo tham chiếu. Đóng băng đối tượng này không đóng băng liên kết count được export riêng.

// modules/counter.mjs
export let count = 0;
export const identity = Object.freeze({});
console.info("evaluate counter.mjs");

export function increment() {
  count += 1;
}
// modules/view.mjs
import { count, identity } from "./counter.mjs";
const initialCount = count;
export const viewIdentity = identity;
console.info("evaluate view.mjs");

export function mountView(root) {
  const live = root.querySelector("#live-count");
  const initial = root.querySelector("#initial-count");
  function render() {
    live.textContent = String(count);
    initial.textContent = String(initialCount);
  }
  render();
  return { render };
}

count là một liên kết import trực tiếp tới giá trị được export. Mỗi lần gọi render(), hàm đọc giá trị hiện tại của nó. Ngược lại, initialCount nhận một số đúng một lần, khi view.mjs được thực thi. Gọi lại hàm render không thực hiện lại khai báo ấy. Tài liệu import phân biệt liên kết import chỉ đọc với đối tượng có thể thay đổi mà một export tham chiếu tới. Module import không thể gán count = 9; module bộ đếm có thể thay đổi liên kết của chính mình qua increment().

Đồ thị phụ thuộc cụ thể cho thấy main và view cùng import một URL bộ đếm; count tăng lên hai trong khi bản chép ban đầu của view vẫn bằng khôngMở ảnh kích thước đầy đủ ↗

Các mũi tên có nghĩa là “phụ thuộc vào”, không phải “tải một kho trạng thái độc lập nữa”. Với đồ thị không có chu trình này, bộ đếm được thực thi trước view, rồi mới tới phần gắn hàm xử lý trong module đầu vào. Thứ tự hoàn tất yêu cầu mạng là một quan sát khác.

Gắn một giao diện nhỏ, dễ kiểm tra

Module đầu vào kết nối các nút HTML gốc và chỉ công bố trạng thái sẵn sàng sau khi các phụ thuộc đã được thực thi. Thao tác thứ hai làm rõ phép so sánh danh tính theo URL. Hãy dùng các tệp này trên một origin thử nghiệm cục bộ riêng.

// modules/main.mjs
import { identity, increment } from "./counter.mjs";
import { mountView, viewIdentity } from "./view.mjs";
console.info("evaluate main.mjs");

const root = document.querySelector("#module-demo");
const button = root.querySelector("#increment-count");
const compare = root.querySelector("#compare-urls");
const result = root.querySelector("#url-result");
const view = mountView(root);
let active = true;
let comparing = false;
root.querySelector("#shared-identity").textContent = identity === viewIdentity
  ? root.dataset.same : root.dataset.different;

function activate() {
  increment();
  view.render();
}
async function compareURLs() {
  if (!active || comparing) return;
  comparing = true;
  compare.setAttribute("aria-busy", "true");
  try {
    const [shared, again, separate] = await Promise.all([
      import("./counter.mjs"), import("./counter.mjs"),
      import("./counter.mjs?copy=1")
    ]);
    if (!active) return;
    const originalBefore = shared.count;
    const separateBefore = separate.count;
    separate.increment();
    result.textContent = [
      `${root.dataset.namespace}: ${shared === again}`,
      `${root.dataset.identity}: ${shared.identity === separate.identity}`,
      `${root.dataset.original}: ${originalBefore} → ${shared.count}`,
      `${root.dataset.copy}: ${separateBefore} → ${separate.count}`
    ].join("\n");
  } catch (error) {
    if (active) result.textContent = `${root.dataset.failed}: ${error.name}`;
  } finally {
    comparing = false;
    compare.removeAttribute("aria-busy");
  }
}
button.addEventListener("click", activate);
compare.addEventListener("click", compareURLs);
button.disabled = compare.disabled = false;
root.querySelector("#module-state").textContent = root.dataset.ready;

export function dispose() {
  active = false;
  button.removeEventListener("click", activate);
  compare.removeEventListener("click", compareURLs);
  button.disabled = compare.disabled = true;
  root.querySelector("#module-state").textContent = root.dataset.stopped;
}

Lưu trang sau thành demo/index.html, còn demo.css đặt ở thư mục gốc mà máy chủ phục vụ. Đường dẫn tuyệt đối của module đầu vào và stylesheet là có chủ ý; import bên trong /modules/main.mjs được phân giải theo URL của chính module đó. Chuyển tệp HTML vào thư mục sâu hơn không làm ./counter.mjs chuyển sang thư mục ấy.

<!doctype html>
<html lang="vi">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Một module chung, hai nơi đọc</title>
  <link rel="stylesheet" href="/demo.css">
  <script type="module" src="/modules/main.mjs"></script>
</head>
<body>
  <section id="module-demo" aria-labelledby="demo-title"
    data-namespace="Cùng URL: cùng đối tượng namespace"
    data-identity="Bản gốc và bản có query: cùng danh tính"
    data-original="Bộ đếm bản gốc"
    data-copy="Bộ đếm bản có query"
    data-failed="So sánh thất bại"
    data-same="Hai nơi import dùng chung một danh tính."
    data-different="Danh tính module khác nhau."
    data-ready="Đã thực thi đồ thị module; nút đã sẵn sàng."
    data-stopped="Đã dừng. Tải lại để khởi tạo giao diện mới.">
    <h1 id="demo-title">Một module chung, hai nơi đọc</h1>
    <p>Module đầu vào và module giao diện import cùng URL bộ đếm. Giao diện đọc lại count liên kết trực tiếp sau mỗi lần kích hoạt.</p>
    <button id="increment-count" type="button" disabled>Tăng thêm một</button>
    <p>Giá trị liên kết hiện tại: <output id="live-count">—</output></p>
    <p>Giá trị chép khi view.mjs được thực thi: <output id="initial-count">—</output></p>
    <p id="shared-identity">Chưa kiểm tra danh tính.</p>
    <p id="module-state">Đang chờ đồ thị module. Nếu tải lỗi, nút vẫn bị vô hiệu hóa.</p>
    <section id="url-panel" aria-labelledby="url-title">
      <h2 id="url-title">So sánh URL đã phân giải</h2>
      <p>Thao tác này import lại counter.mjs và import counter.mjs?copy=1, rồi chỉ tăng bộ đếm của bản có query.</p>
      <button id="compare-urls" type="button" disabled>So sánh URL module</button>
      <pre id="url-result" role="status">Chưa thực hiện so sánh.</pre>
    </section>
  </section>
</body>
</html>
/* demo.css */
* { box-sizing: border-box; }
body { margin: 1rem; font: 1rem/1.6 system-ui, sans-serif; }
#module-demo { max-inline-size: 40rem; overflow-wrap: anywhere; }
button { font: inherit; max-inline-size: 100%; white-space: normal; }
output { font-weight: 700; }
:focus-visible { outline: 3px solid #315b32; outline-offset: 3px; }
pre { font: inherit; white-space: pre-wrap; overflow-wrap: anywhere; }
#url-panel { border-block-start: 1px solid #777; margin-block-start: 2rem; }

Phục vụ thư mục chứa modules, demo và demo.css, chẳng hạn bằng python3 -m http.server 8080, rồi mở /demo/index.html. Kiểm tra phản hồi module có MIME type dành cho JavaScript. Hậu tố .mjs không thể sửa một máy chủ đang trả về trang HTML dự phòng. Mở trực tiếp bằng file: cũng không tái hiện môi trường HTTP này.

Tài liệu phần tử script giải thích vì sao module đầu vào thông thường không cần thêm defer: module script có hành vi trì hoãn mặc định. async thay đổi cách lập lịch, nên ví dụ không thêm thuộc tính ấy. Các module ở đây khởi tạo đồng bộ ở cấp cao nhất; ví dụ không xác lập quy tắc hoàn tất cho mọi đồ thị có await ở cấp cao nhất.

Ảnh trình duyệt thật sau Space và Enter hiển thị count hiện tại bằng hai, bản chép ban đầu bằng không, cùng danh tính module và đồ thị đã sẵn sàngMở ảnh kích thước đầy đủ ↗

Ảnh này được chụp từ đúng ví dụ trong Chrome 153: Tab đưa focus tới nút đầu, rồi Space và Enter kích hoạt nút. Giao diện giữ nguyên phần tử nút. Phạm vi module giữ count ngoài window; tìm window.count sẽ không đọc được kho trạng thái này.

Trong lúc so sánh, cờ đang xử lý chặn kích hoạt lặp, còn aria-busy báo công việc đang diễn ra. Nút đang có focus vẫn được bật, tránh mất focus bàn phím do tạm vô hiệu hóa. Import thành công hay bị từ chối đều xóa trạng thái bận.

Các nút bị vô hiệu hóa lúc đầu cũng biểu đạt đúng tình trạng khi có lỗi. Module đầu vào hỏng thì lời giải thích vẫn hiện, còn nút không hoạt động. Ví dụ không bổ sung dịch vụ báo lỗi sản phẩm và không giả vờ rằng ứng dụng đã khởi tạo thành công.

Đo việc phát hiện phụ thuộc riêng với thực thi

Tôi phục vụ các trang mới với độ trễ phản hồi chủ động đặt là 180 mili giây cho bộ đếm và 40 mili giây cho view. Biểu đồ dùng thời điểm bắt đầu yêu cầu và tải xong do trình duyệt ghi lại, không lấy độ trễ cấu hình thay cho số đo. Cả ba yêu cầu trả về JavaScript với mã 200; bộ đếm chỉ xuất hiện một lần dù có hai nơi import.

Các khoảng yêu cầu đo tại máy cục bộ cho thấy module đầu vào đến trước khi các phụ thuộc được yêu cầu; phản hồi bộ đếm bị trì hoãn lâu hơn phản hồi viewMở ảnh kích thước đầy đủ ↗

Đây là thí nghiệm tải cục bộ, không phải benchmark mạng. Các khoảng đo vẫn chứa chi phí phân tích, lập lịch và đo đạc. Bài viết không khẳng định độ trễ sản phẩm, kết nối di động hay kết quả bundler. Điều hữu ích nằm ở cấu trúc: trình duyệt phải nhận mã nguồn của module import để phát hiện các phụ thuộc tĩnh, trừ khi một cơ chế khác đã cung cấp thông tin ấy.

Console vẫn ghi thứ tự thực thi là counter, view, rồi main. Phản hồi view đến trước không cho phép view đọc bộ đếm chưa khởi tạo. Khi thêm import, cần suy nghĩ về phụ thuộc và khởi tạo, chứ không chỉ sắp các thẻ script theo một thứ tự trông hợp lý. Preload và bundling là những lựa chọn phân phối có thể cân nhắc, nhưng thí nghiệm này không so sánh hiệu năng của chúng.

Phân loại lỗi trước khi sửa mã

Bảng sau tổng hợp các thay đổi riêng lẻ trên đồ thị này. Mỗi trường hợp dùng một trang mới, giữ giao diện ban đầu với nút bị vô hiệu hóa, rồi thử dynamic import để ghi loại lỗi bị từ chối. Nội dung thông báo lỗi tùy cách triển khai; đây là những loại quan sát trong Chrome, không phải chuỗi cố định để ứng dụng luôn đối chiếu.

Bảng chi tiết tách các trường hợp thiếu phản hồi, MIME sai, tên rút gọn chưa ánh xạ, thiếu export, lỗi khởi tạo, đọc sớm trong chu trình và tải khác origin bị chặnMở ảnh kích thước đầy đủ ↗

Để thử lỗi phân giải, thay specifier của bộ đếm bằng tên rút gọn chưa được ánh xạ, chẳng hạn counter-package. Trình duyệt không tự tìm trong node_modules; hãy dùng import map hoặc bộ phân giải lúc build của dự án nếu đó là cách dự định vận hành. Với lỗi tải, kiểm tra URL được yêu cầu, mã trạng thái, nội dung phản hồi và MIME type. Trang HTML dự phòng mang mã HTTP 200 vẫn không phải JavaScript phù hợp. Module khác origin còn cần phản hồi CORS thích hợp; trường hợp đối chứng ở cổng cục bộ thứ hai thành công khi phản hồi cho phép origin gửi yêu cầu.

Để thử lỗi liên kết, import một export có tên không tồn tại từ bộ đếm hợp lệ. Tải được JavaScript hợp lệ không bảo đảm các export tương thích. Để thử lỗi thực thi, ném lỗi trong phần khởi tạo bộ đếm. Đồ thị có thể tải và liên kết thành công nhưng hỏng khi chạy.

Chu trình cần được chẩn đoán chính xác hơn câu “không được có chu trình”. Thêm import chỉ để thực thi view.mjs ở đầu module bộ đếm khiến đồ thị này đọc count trước khi nó được khởi tạo, dẫn tới ReferenceError. Một phép đối chứng khác trì hoãn việc đọc trong chu trình tới sau khi cả hai module khởi tạo thì thành công. Hãy tách dữ liệu dùng chung hoặc thiết kế lại quá trình khởi tạo khi có thể; một timer tùy ý không xác lập quan hệ phụ thuộc.

URL khác có thể tạo trạng thái khác

Trên trang mới, kích hoạt bộ đếm hai lần rồi dùng “So sánh URL module”. Hai import giống nhau trả về cùng đối tượng namespace, tức đối tượng chứa các export của module. URL có query trả về danh tính bộ đếm riêng; thay đổi bộ đếm ấy không làm count của bản gốc đổi theo.

Ảnh trình duyệt thật hiển thị cùng namespace với cùng URL, danh tính khác nhau khi URL có query, bộ đếm gốc vẫn bằng hai và bản có query tăng từ không lên mộtMở ảnh kích thước đầy đủ ↗

Lặp lại phép so sánh: bản có query tăng từ một lên hai. Mã dùng lại URL cố định ?copy=1; nó không tạo kho trạng thái mới sau mỗi click. Trang hoặc frame mới có môi trường tải riêng, nên nhận định dùng chung chỉ áp dụng cho đồ thị module trong trang này. Nó không phải cơ sở dữ liệu dùng chung giữa các tab.

Bạn cũng có thể kiểm tra sự khác biệt ấy từ console. Hãy tải lại trang trước đoạn chẩn đoán nếu muốn nhận đúng giá trị trong chú thích cuối; thao tác so sánh trên giao diện cũng tăng bộ đếm của bản có query.

// Run in the browser console after opening the working example.
const shared = await import("/modules/counter.mjs");
const again = await import("/modules/counter.mjs");
const separate = await import("/modules/counter.mjs?copy=1");
console.log(shared === again); // true
console.log(shared.identity === separate.identity); // false
const before = shared.count;
separate.increment();
console.log(shared.count === before); // true
console.log(separate.count); // 1 on the first run in a fresh document

Tài liệu dynamic import mô tả việc dùng lại namespace và danh tính theo URL có query. Liên tục tạo URL mới là cách thay thế kém cho trạng thái ứng dụng được quản lý rõ ràng: nó tạo thêm module instance mà không có API xóa cache namespace. Nếu mỗi widget cần bộ đếm độc lập, hãy export một factory tạo trạng thái thông thường do từng widget sở hữu.

Cuối cùng, dispose() gỡ cả hai hàm xử lý và vô hiệu hóa các nút. Nếu import phục vụ phép so sánh còn đang chờ, kiểm tra active ngăn kết quả đến sau thay đổi bản có query hoặc công bố đầu ra. Nó không hủy tải và không gỡ module đã thực thi khỏi bộ nhớ. Như vậy, vòng đời của giao diện được tách khỏi vòng đời module.

Để tự luyện, dự đoán những giá trị nào đổi khi kích hoạt nút bộ đếm gốc sau ba lần so sánh, rồi kiểm chứng. Tiếp theo, chỉ chuyển tệp HTML và xác nhận URL module được yêu cầu không đổi. Hai kiểm tra nhỏ này tách quyền sở hữu trạng thái khỏi phân giải URL, giúp bạn điều tra báo lỗi “không tải được module” trong hệ thống lớn dễ hơn.

Nguồn tham khảo & đọc thêm

  1. MDN: JavaScript modules
  2. MDN: import declaration
  3. MDN: script element
  4. MDN: dynamic import
← Về trang bài viết

Hình minh họa

100%