TopGit
Đánh giá repo GitHub

Async: async npm library để kiểm soát luồng bất đồng bộ

caolan/async
ATopGit review image for caolan/async
Review by Topgit.dev for caolan/async, with GitHub repository stats and README context.
Nhận định nhanh

Async tồn tại qua giai đoạn JavaScript chuyển từ callback sang promise gốc vì nó chưa bao giờ ép người dùng chọn một bên — ví dụ trong README bọc một hàm async ES2017 ngay trong async.mapLimit. Giá trị thật nằm ở đó: một bộ hàm kiểm soát luồng dùng được cho cả callback lẫn async/await. Đây không phải hàng thay thế Promise.all cho tác vụ song song đơn giản; Async đáng dùng khi bạn cần giới hạn concurrency như của mapLimit.

Sao
★ 28.1k
Fork
⑂ 2.4k
Ngôn ngữ
JavaScript
Giấy phép
MIT
Chủ đề
Frontend
Cập nhật
Nov 2026
Trang chủ
GitHub

Async là gì?

Async là một module tiện ích npm, cài bằng npm i async, dùng để xử lý JavaScript bất đồng bộ trên cả Node.js lẫn trình duyệt. Package này kèm bản build ESM/MJS mà Webpack và Rollup tự động nhận diện, và các hàm của nó chấp nhận cả callback kiểu Node lẫn async/await ES2017 — forEachOf và mapLimit là hai ví dụ ngay trong README. Ngoài ra còn có gói ESM thuần riêng là async-es.

Các hàm tiện ích async cốt lõi

  • ✓forEachOf lặp qua một object hoặc array và chạy một callback bất đồng bộ cho từng phần tử, gộp lại thành một lỗi cuối cùng thay vì bạn phải tự theo dõi tiến trình hoàn thành.
  • ✓mapLimit chạy một hàm bất đồng bộ trên một danh sách với giới hạn số tác vụ đồng thời — ví dụ trong README giới hạn ở 5 lệnh gọi cùng lúc.
  • ✓Các hàm chấp nhận cả callback kiểu error-first của Node lẫn hàm async/await ES2017, thể hiện song song trong hai ví dụ của README.
  • ✓Đi kèm bản build ESM/MJS ngay trong gói async chính, được Webpack và Rollup tự động nhận diện, không cần cấu hình riêng.
  • ✓Một gói ESM thuần, async-es, được phát hành riêng cho các dự án muốn dependency chỉ dùng ESM.
  • ✓Chạy trực tiếp trên trình duyệt cũng như trên Node.js.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Cài đặt Async qua npm

Cài bằng npm i async. Lệnh này lấy về gói chính, vốn ưu tiên CommonJS nhưng có kèm bản build ESM/MJS mà các bundler tương thích như Webpack và Rollup tự động dùng — không cần thêm flag nào. Nếu muốn một dependency thuần ESM, cài async-es thay vì async. Tài liệu API đầy đủ nằm ở caolan.github.io/async, tách riêng khỏi README; bản thân README không mô tả chi tiết từng hàm.

Dùng Async với callback và async/await

Ví dụ đầu tiên trong README require async bằng require("async") và gọi async.forEachOf trên một object chứa đường dẫn file, đọc và JSON.parse từng file trong callback, rồi xử lý một lỗi tổng hợp duy nhất trong callback cuối cùng sau khi mọi phần tử đã chạy xong. Ví dụ thứ hai gọi async.mapLimit(urls, 5, ...) và truyền vào một hàm async ES2017 await trực tiếp fetch(url) — Async chạy hàm async đó dưới cùng cơ chế kiểm soát luồng có giới hạn concurrency, nên code kiểu callback và code async/await có thể nằm cạnh nhau trong cùng một dự án.

Điểm mạnh

  • ✓Chấp nhận cả callback kiểu error-first lẫn hàm async/await ES2017 qua cùng một API, nên code callback sẵn có không cần viết lại để bắt đầu dùng.
  • ✓Có sẵn bản build ESM/MJS trong gói chính, được Webpack và Rollup tự động nhận diện, cộng thêm async-es cho ai cần thiết lập ESM thuần.
  • ✓Giấy phép MIT nên dễ dùng trong dự án thương mại và mã nguồn đóng mà không vướng ràng buộc license.
  • ✓Chạy không cần chỉnh sửa trên trình duyệt cũng như trên Node.js.

Khi nào không nên dùng Async

  • △Bản thân README không mô tả chi tiết hành vi từng hàm — bạn phải sang trang docs riêng để tra cứu từng hàm hoạt động thế nào.
  • △Hai gói chồng lấn nhau, async và async-es, buộc bạn phải chọn đúng gói theo hệ thống module thay vì chỉ có một lựa chọn cài đặt duy nhất.
  • △Đủ lâu đời để vẫn còn link tới docs v1.5.x đã lưu trữ, nên các tutorial hay câu trả lời viết theo phiên bản đó sẽ không khớp với API hiện tại.

Lựa chọn thay thế cho Async

Promise gốc (Promise.all / Promise.allSettled) — không cần thêm dependency nào nếu bạn chỉ cần chạy song song vài promise.Bluebird — một thư viện promise khác với các hàm kiểm soát concurrency riêng, một lựa chọn cũ hơn từ cùng giai đoạn chuyển từ callback sang promise.RxJS — dùng luồng reactive thay vì các hàm kiểm soát luồng một lần, bước nhảy khái niệm lớn hơn nhưng hợp với dữ liệu sự kiện liên tục mà Async không mô hình hóa.p-limit — một thư viện nhỏ, chuyên biệt để giới hạn concurrency cho promise, nếu bạn chỉ cần tính năng giới hạn như mapLimit mà không cần cả bộ hàm của Async.

Câu hỏi thường gặp

Async có còn được bảo trì trong năm 2024 không?

Các thông tin ở đây không nêu ngày commit cụ thể trong 2024, nhưng Async vẫn phát hành gói npm hiện hành kèm trang docs được duy trì và một bản lưu trữ tài liệu v1.5.x riêng cho phiên bản cũ — kiểu duy trì mà một dự án bị bỏ rơi thường không còn làm.

Async có dùng được cả trên Node.js lẫn trình duyệt không?

Có. Async cài bằng npm i async cho Node.js, và cùng gói đó cũng chạy trực tiếp được trên trình duyệt. Nó còn kèm bản build ESM/MJS mà các bundler như Webpack và Rollup tự động nhận diện.

Async có giấy phép MIT và miễn phí cho mục đích thương mại không?

Async phát hành theo giấy phép MIT, một giấy phép mã nguồn mở khá thoáng, cho phép dùng cho mục đích thương mại, mã nguồn đóng, chỉnh sửa và phân phối lại — bạn chỉ cần giữ nguyên thông báo bản quyền gốc.

Async có hỗ trợ ES modules (ESM) không?

Có, Async hỗ trợ ES modules. Gói async chính đi kèm bản build ESM/MJS mà các bundler tương thích tự động nhận diện, và còn có một gói ESM thuần riêng, async-es, dành cho ai muốn dependency chỉ dùng ESM.

Async so với dùng Promise gốc trực tiếp thì thế nào?

Async không thay thế Promise gốc — chính ví dụ trong README của nó bọc một hàm async ES2017 bên trong async.mapLimit thay vì cạnh tranh với nó. Promise.all gốc đơn giản hơn cho một tác vụ song song một lần; Async chỉ đáng dùng khi bạn cần một hàm có sẵn như giới hạn concurrency của mapLimit hay lặp object của forEachOf.

Sự khác biệt giữa gói async và async-es là gì?

Gói async ưu tiên CommonJS nhưng kèm theo bản build ESM/MJS mà Webpack và Rollup tự động nhận diện. async-es là một gói ESM thuần riêng biệt, dành cho dự án muốn dependency chỉ dùng ESM mà không cần bước tự nhận diện đó. Cả hai đều đến từ cùng dự án caolan/async.

Vấn đề mà Async giải quyết

Callback kiểu error-first của Node khiến việc lặp qua một danh sách hay object để làm việc bất đồng bộ — như đọc nhiều file cùng lúc — biến thành code lồng nhau sâu hoặc phải tự viết bộ đếm để biết khi nào tất cả callback đã chạy xong. Hàm forEachOf của Async, dùng ngay trong ví dụ README để lặp qua một object chứa đường dẫn file cấu hình, thay thế việc tự đếm đó bằng một lệnh gọi duy nhất, trả về một lỗi tổng hợp cuối cùng hoặc không có lỗi nào.

Trường hợp sử dụng phù hợp nhất

  • •Đọc và parse nhiều file JSON cấu hình thành một object duy nhất mà không cần lồng callback — đúng theo cách ví dụ forEachOf trong README của Async làm.
  • •Fetch một danh sách URL với giới hạn số request đồng thời thay vì gửi tất cả cùng lúc, theo cách async.mapLimit(urls, 5, ...) làm trong README.
  • •Chuyển dần một codebase dùng callback kiểu Node sang async/await, vì các hàm của Async chấp nhận cả hai kiểu.
  • •Build cho trình duyệt bằng Webpack hoặc Rollup, nơi bản build ESM/MJS đi kèm được tự động nhận diện.

Ai nên dùng — và ai nên bỏ qua

Các team đang có sẵn code callback kiểu Node cần các hàm kiểm soát luồng — như lặp với giới hạn concurrency — mà không muốn viết lại toàn bộ sang promise sẽ tận dụng Async tốt nhất. Một dự án mới bắt đầu từ async/await, không có di sản callback nào, thì ít lý do để thêm Async vào: Promise.all và một vòng lặp thường đã đủ cho các trường hợp đơn giản mà không cần thêm dependency.

Repo liên quan

Nguồn & ghi công

Các thông tin, ví dụ code và metadata về license/topic được lấy từ repository GitHub caolan/async (https://github.com/caolan/async) và README của nó.

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

async có đáng để bạn bỏ thời gian?

ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về async.

GitHub