whatwg-fetch polyfill: window.fetch cho trình duyệt cũ
whatwg-fetch vá window.fetch để các request kiểu Promise chạy được trên những trình duyệt chưa từng có Fetch API gốc. Đây là lựa chọn hợp lý khi Internet Explorer 10 hoặc 11 vẫn còn trong danh sách trình duyệt cần hỗ trợ, và trở thành phần thừa ngay khi bạn bỏ IE — Chrome, Firefox, Safari hiện đại đều đã có fetch gốc, nên code của polyfill chỉ nằm im trong bundle mà không chạy.
whatwg-fetch là gì?
whatwg-fetch là một polyfill JavaScript, phát hành dưới dạng gói npm whatwg-fetch, hiện thực một phần đặc tả WHATWG Fetch — đủ để thay thế phần lớn cách dùng XMLHttpRequest trên trình duyệt chưa có fetch gốc. Khi import, nó vá thẳng vào đối tượng toàn cục window.fetch, nên code đã gọi fetch() từ trước sẽ chạy được ngay mà không cần bọc thêm lớp nào. Nó chỉ chạy trên trình duyệt — README nói rõ là không hoạt động trong môi trường Node.js.
Các tính năng và tùy chọn fetch được hỗ trợ
- ✓Hiện thực một phần đặc tả WHATWG Fetch — đủ cho các trường hợp thay thế XMLHttpRequest thông thường, không phủ hết toàn bộ đặc tả.
- ✓Các lệnh gọi fetch() theo kiểu Promise, trả về đối tượng Response với .status, .statusText, .headers.get(), .json() và .text().
- ✓Hỗ trợ sẵn FormData để submit form và upload file mà không cần tự dựng request XHR thô.
- ✓Hỗ trợ mẫu abortable fetch qua AbortController và AbortSignal, khi kết hợp thêm một polyfill AbortController cho trình duyệt chưa có sẵn.
- ✓Tùy chọn credentials có thể cấu hình (mặc định same-origin, dùng include cho request CORS) để kiểm soát việc gửi cookie giữa các origin.
- ✓Export thẳng phần hiện thực polyfill (import {fetch as fetchPolyfill} from 'whatwg-fetch') để bạn gọi rõ ràng song song với window.fetch gốc.
Cài đặt whatwg-fetch
Cài bằng `npm install whatwg-fetch --save`. README cũng nhắc một phụ thuộc khác đừng bỏ qua: whatwg-fetch cần một Promise polyfill trên trình duyệt cũ, và dự án gợi ý dùng taylorhakes/promise-polyfill cho việc đó. Với webpack, thêm 'whatwg-fetch' vào mảng entry, đặt trước entry point của ứng dụng, để việc vá window.fetch chạy trước code của bạn.
Sử dụng polyfill trong code
Import whatwg-fetch sẽ chạy polyfill ngay lập tức và vá window.fetch: `import 'whatwg-fetch'` rồi gọi `window.fetch(...)` như bình thường. Nếu cần dùng đúng phần hiện thực polyfill — ví dụ để có tính năng abort trên trình duyệt có fetch gốc nhưng là bản cũ — import theo tên thay vào đó: `import {fetch as fetchPolyfill} from 'whatwg-fetch'`. Từ đó, cách gọi khớp với đặc tả: `fetch('/users.json').then(r => r.json())` cho JSON, truyền một instance FormData làm body khi upload file, và đọc `response.headers.get('Content-Type')` hay `response.status` từ Response trả về.
Điểm mạnh
- ✓Giống hệt cách gọi fetch() thật — code viết theo polyfill không cần sửa gì khi trình duyệt hiện đại tự dùng fetch gốc.
- ✓Phạm vi nhỏ, gọn: chỉ vá đúng một global rồi thôi, không kèm theo cả một HTTP client đầy interceptor và lớp cấu hình.
- ✓Phần Caveats trong README nói thẳng những gì không hoạt động (keepalive, các chế độ redirect, cache directive), nên bạn không phải tự mò ra từng lỗ hổng.
- ✓Giấy phép MIT, code đủ nhỏ để đọc hết trong một lần ngồi nếu request có hành vi bất thường.
Giới hạn và lưu ý cần biết
- △Promise trả về không reject khi HTTP trả mã lỗi — response 404 hay 500 vẫn resolve bình thường, nên bạn phải tự kiểm tra status (theo mẫu checkStatus() trong README) để coi mã lỗi là thất bại.
- △keepalive hoàn toàn không được hỗ trợ, vì làm việc đó cần một XHR đồng bộ, điều mà nhóm phát triển đã từ chối thêm vào.
- △Tùy chọn redirect và cache bị bỏ qua — chỉ chế độ redirect mặc định 'follow' hoạt động, vì XMLHttpRequest bên dưới không lộ ra các chế độ khác.
- △Giá trị mặc định của cookie khác nhau theo phiên bản trình duyệt: Firefox 39-60, Chrome 42-67 và Safari 10.1-11.1.2 từng mặc định 'omit' theo một bản nháp đặc tả fetch cũ hơn, nên nếu còn nhắm tới các bản này thì nên set credentials rõ ràng thay vì dựa vào mặc định.
- △Muốn abort request thì cần thêm một polyfill khác (AbortController/AbortSignal không có sẵn), và response.url có thể không đáng tin sau redirect trên trình duyệt cũ trừ khi server set header X-Request-URL.
Các lựa chọn thay thế cho whatwg-fetch
Câu hỏi thường gặp
whatwg-fetch được thiết kế để chạy trên Internet Explorer 10 và 11 — điều này được ghi rõ trong phần browser support của README, cùng với Chrome, Firefox và Safari 6.1+. Vì IE chưa bao giờ có window.fetch gốc, đây chính là một trong những lý do polyfill này ra đời — không có nó, fetch() đơn giản là không tồn tại để gọi trên các trình duyệt đó.
Promise mà whatwg-fetch trả về vẫn resolve bình thường ngay cả khi response là 404 hay 500 — nó chỉ reject khi network lỗi. Để làm cho lỗi HTTP reject, viết một hàm kiểm tra status, throw khi response.status nằm ngoài khoảng 200-299, rồi chain hàm đó trước .then(parseJSON), đúng theo mẫu checkStatus() mà README đưa ra.
whatwg-fetch mặc định tùy chọn credentials là 'same-origin', nên cookie chỉ tự gửi tới cùng domain, không gửi cho request CORS sang domain khác. Với request cross-origin cần cookie, hãy set credentials: 'include' rõ ràng; một số bản Firefox, Chrome, Safari cũ từng mặc định 'omit' theo một bản đặc tả fetch cũ hơn, đó là lý do README khuyên luôn set credentials tường minh.
whatwg-fetch dùng được với webpack bằng cách thêm tên gói vào mảng entry, đặt trước entry point của ứng dụng trong cấu hình webpack, để việc vá window.fetch chạy trước code của bạn. Đây đúng là cách README hướng dẫn cho các dự án dùng bundler, không cần thêm loader hay plugin nào khác.
whatwg-fetch hỗ trợ mẫu abortable fetch, nhưng chỉ khi kết hợp thêm một polyfill AbortController/AbortSignal riêng, vì các trình duyệt cũ đến mức thiếu fetch gốc cũng thường thiếu luôn hai API DOM này. README chỉ tới gói yet-another-abortcontroller-polyfill cho phần đó; khi có đủ cả hai, gọi controller.abort() trên request truyền qua tùy chọn signal sẽ huỷ request giống hệt fetch gốc.
whatwg-fetch không có tác dụng gì trên trình duyệt hiện đại đã có sẵn window.fetch gốc — README nói rõ là không dòng code nào của polyfill được chạy ở đó. Import nó vẫn vô hại nhưng thừa: các lệnh gọi fetch() chỉ dùng đúng hiện thực có sẵn của trình duyệt, đây cũng là lý do báo lỗi về hành vi fetch gốc nên gửi cho nhà phát triển trình duyệt, không phải cho dự án này.
Vấn đề mà nó giải quyết
Trước khi có fetch gốc, viết HTTP request chạy được trên nhiều trình duyệt nghĩa là phải tự code theo API callback, không Promise của XMLHttpRequest — mỗi trình duyệt lại xử lý form, đọc header, bắt lỗi theo một kiểu khác nhau. Điều whatwg-fetch giải quyết cụ thể hơn 'làm HTTP dễ hơn': nó cho phép viết đúng theo chữ ký fetch() thật, kiểu Promise, ở mọi nơi, kể cả Internet Explorer 10 và 11, nên một codebase không cần một kiểu request cho trình duyệt cũ và một kiểu khác cho trình duyệt hiện đại.
Trường hợp sử dụng phù hợp nhất
- •Đưa một web app lên production mà vẫn phải hỗ trợ Internet Explorer 10 hoặc 11, mà không phải duy trì hai nhánh code request riêng biệt.
- •Chuẩn hoá codebase theo API fetch() trước khi bỏ hỗ trợ IE, để sau này gỡ polyfill chỉ còn là xoá một dòng import.
- •Dùng webpack và muốn fetch có sẵn toàn cục bằng cách thêm whatwg-fetch vào mảng entry, trước entry point của ứng dụng.
- •Xử lý upload file bằng FormData trên trình duyệt cũ, nơi tự viết XMLHttpRequest thô sẽ tốn nhiều code hơn.
Nên dùng — và nên bỏ qua
Những team vẫn phải chạy trên Internet Explorer 10 hoặc 11 — hay bất kỳ môi trường nào chưa có fetch gốc — nên thêm whatwg-fetch và viết code theo đúng API fetch() thật, thay vì tự bọc XMLHttpRequest. Những team đã bỏ IE và chỉ nhắm tới Chrome, Firefox, Safari bản mới nên bỏ qua nó — chính README cũng nói code polyfill không có tác dụng gì ở đó, chỉ tốn thêm byte mà không đổi hành vi. Ai cần interceptor cho request/response, tự động retry, hay tương thích Node.js thì nên tìm một HTTP client đầy đủ hơn thay vì một fetch shim.
Repo liên quan
Vẫn đang phân vân về fetch?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về fetch.
