npm scripts và lifecycle hook là gì?

Question

Accepted Answer

**npm scripts** là các lệnh định nghĩa trong trường `scripts` của `package.json` mà bạn chạy bằng `npm run `. Chúng chuẩn hóa các tác vụ dự án (start, build, test, lint) để cả nhóm và CI dùng cùng lệnh. **Lifecycle hook** là các script đặc biệt npm chạy tự động tại một số thời điểm. ## Định nghĩa và chạy script ```json { "scripts": { "start": "node server.js", "dev": "nodemon server.js", "build": "tsc && vite build", "test": "vitest", "lint": "eslint src", "format": "prettier --write ." } } ``` ```bash npm run dev # bất kỳ script nào npm start # `start` và `test` có lối tắt (không cần "run") npm test ``` Script có thể nối lệnh bằng `&&` (chạy tuần tự, dừng khi thất bại) và truy cập các binary cài cục bộ (trong `node_modules/.bin`) không cần đường dẫn — nên `"test": "vitest"` chạy được dù vitest không cài toàn cục. ## Hook pre và post (tự động) ```json { "scripts": { "prebuild": "rimraf dist", // chạy TỰ ĐỘNG trước "build" "build": "tsc", "postbuild": "echo done" // chạy TỰ ĐỘNG sau "build" } } ``` npm tự động chạy `pre` trước và `post` sau bất kỳ script `` nào. Nên `npm run build` chạy `prebuild` → `build` → `postbuild` theo thứ tự — tiện cho bước thiết lập/dọn dẹp. ## Lifecycle hook tích hợp ```json { "scripts": { "postinstall": "node setup.js", // chạy sau khi `npm install` xong "prepare": "husky install" // chạy sau install (thường thiết lập git hook) } } ``` Các hook như `postinstall` và `prepare` chạy tại các thời điểm định trước của vòng đời cài đặt — thường dùng để thiết lập git hook (husky) hoặc biên dịch dependency native. (Cẩn thận: script `postinstall` trong dependency cũng là một mối lo bảo mật chuỗi cung ứng.) ## Truyền tham số và biến môi trường ```bash npm run test -- --watch # truyền tham số cho script sau -- NODE_ENV=production npm start # đặt biến môi trường cho lần chạy ``` ## Vì sao dùng npm scripts thay vì Makefile/công cụ toàn cục ```text ✓ Tự tài liệu hóa — `package.json` hiện mọi tác vụ có sẵn ✓ Khá đa nền tảng, không cần cài toàn cục (dùng node_modules/.bin cục bộ) ✓ Chuẩn trong hệ sinh thái JS — mọi dev đều biết `npm run` ``` ## Tại sao điều này quan trọng npm scripts là task runner chuẩn cho dự án Node/JS — chúng tập trung và tài liệu hóa cách start, build, test và lint app, đảm bảo mọi người (và CI) chạy các lệnh giống hệt. Hiểu cách kết hợp script, các hook `pre`/`post` tự động (cho thiết lập/dọn dẹp), và các lifecycle hook như `postinstall`/`prepare` giúp bạn tự động hóa luồng dự án gọn gàng. Chúng là chất kết dính của công cụ dự án và xuất hiện trong gần như mọi kho Node.