---
title: "Sửa lỗi Cannot use import statement outside a module trong trình duyệt và Node.js"
description: "SyntaxError: Cannot use import statement outside a module nghĩa là tệp đã chạy như script cổ điển hoặc như CommonJS. Hãy tải tệp như một module, và cùng câu import đó sẽ chạy."
canonical: "https://logbrew.co/vi/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Sửa lỗi Cannot use import statement outside a module trong trình duyệt và Node.js

`SyntaxError: Cannot use import statement outside a module` nghĩa là tệp đã chạy như script cổ điển hoặc như CommonJS. Hãy tải tệp như một module, và cùng câu `import` đó sẽ chạy.

Đã thử nghiệm ngày 21 tháng 11, 2026 với Chrome 157, Safari 27.2, Node.js 22.18.0 và @logbrew/browser 0.1.22

Tác giả [Furkan Erday](https://github.com/furkanerday). Furkan Erday là nhà sáng lập LogBrew. Anh xây dựng LogBrew bằng Claude Code và Codex mỗi ngày.

Canonical: https://logbrew.co/vi/errors/cannot-use-import-statement-outside-a-module

## 5 thẻ script đã làm gì với 1 câu `import`

| Cách trang tải tệp | Mã đã chạy | Vấn đề trong LogBrew |
| --- | --- | --- |
| `<script src>` không có kiểu | Không | `SyntaxError` |
| `<script>` nội tuyến | Không | `SyntaxError` |
| `<script src>` từ origin khác | Không | `Error`, dòng 0 |
| SDK trong script `type="module"` | Không | Không |
| `<script type="module">` | Có | Không có lỗi |

Chrome 157 và Safari 27.2 cho cùng kết quả với mỗi thẻ.

## Tìm nơi tệp chạy như script cổ điển

### Xem thẻ script tải tệp

Thẻ không có thuộc tính `type`, nên trình duyệt đọc `app.js` như script cổ điển, và script cổ điển không dùng được `import`. Chrome 157 dừng ở dòng 1, cột 1, trước khi bất kỳ dòng nào của tệp chạy. Một script nội tuyến cho cùng thông báo.

```bash
<!-- index.html -->
<script src="/app.js"></script>

// app.js
import { pour } from "./tap.js";

pour("IPA");
```

Kết quả

```text
Uncaught SyntaxError: Cannot use import statement outside a module
```

### Safari báo một thông báo khác cho cùng tệp

Safari 27.2 đọc cùng tệp `app.js` và ném `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` Thông báo nói về một lệnh gọi `import()` và không nhắc đến module. Nguyên nhân và cách sửa vẫn như nhau.

Kết quả

```text
SyntaxError: Unexpected token '{'. import call expects one or two arguments.
```

### Câu export trong script cổ điển cũng lỗi

Một tệp chỉ export, được tải bằng thẻ cổ điển, dừng ở câu `export` đầu tiên. Chrome báo `Unexpected token 'export'`, còn Safari báo `Unexpected keyword 'export'`. Cả 2 đều có nghĩa là trang đã tải một module như script cổ điển.

```bash
// tap.js, loaded with <script src="/tap.js"></script>
export function pour(beer) {
  document.body.dataset.poured = beer;
}
```

Kết quả

```text
Uncaught SyntaxError: Unexpected token 'export'
```

### Trong Node.js, xem trường type của package.json

Node.js 22.18.0 ném cùng thông báo khi `package.json` có `"type": "commonjs"`. Stack đi qua `wrapSafe` trong loader CommonJS. Khi không có trường `type`, Node.js chạy tệp như module và in ra một cảnh báo thay vì lỗi.

```bash
// package.json
{ "name": "lab", "type": "commonjs" }

// node app.js
import { pour } from "./tap.js";
```

Kết quả

```text
import { pour } from "./tap.js";
^^^^^^

SyntaxError: Cannot use import statement outside a module
    at wrapSafe (node:internal/modules/cjs/loader:1620:18)
    at Module._compile (node:internal/modules/cjs/loader:1662:20)
```

## Tải tệp như một module

### Thêm kiểu module vào thẻ script

Với `type="module"` trên cùng thẻ, `app.js` và câu `import` của nó đã chạy trong Chrome 157 và Safari 27.2. Khi đó trình duyệt tự tải `tap.js` cho bạn. Nếu một thẻ cổ điển cũng tải `tap.js`, hãy xóa thẻ đó, vì nó vẫn dừng ở `export`.

```bash
<script type="module" src="/app.js"></script>
```

### Đặt kiểu module trong package.json

Đặt `"type": "module"` trong `package.json`, hoặc đổi tên tệp thành `.mjs`. Cả 2 cách đều chạy tệp của chúng tôi mà không có cảnh báo. Node.js đọc tệp `.mjs` là module và tệp `.cjs` là CommonJS, bất kể trường `type` ghi gì.

```bash
// package.json
{ "name": "lab", "type": "module" }

// node app.js
```

Kết quả

```text
poured IPA
```

### Tải SDK của LogBrew trước trong một script cổ điển

Lỗi phân tích cú pháp xảy ra trước khi bất kỳ dòng nào của tệp đó chạy, nên trình nghe lỗi phải có sẵn trên trang. Trình duyệt chỉ chạy script module sau khi đọc xong trang, nên script module đến quá muộn. Khi SDK nằm trong script cổ điển ở `<head>`, LogBrew đã ghi nhận lỗi. Khi SDK nằm trong script `type="module"`, không có gì được ghi nhận.

```bash
// logbrew.ts
import { installLogBrewBrowser } from "@logbrew/browser";

installLogBrewBrowser({ clientKey: "LOGBREW_BROWSER_KEY" });

// bun build logbrew.ts --format=iife --outfile=public/logbrew.js
// index.html, in <head> before every other script:
// <script src="/logbrew.js"></script>
```

## Kết quả khi chúng tôi thử nghiệm

Chúng tôi phục vụ 1 trang tại `http://127.0.0.1:28180` và mở nó trong Chrome 157 và Safari 27.2, với `@logbrew/browser` 0.1.22 được tải đầu tiên. Chúng tôi tải cùng một đoạn mã theo 5 cách và đọc `error.message` từ sự kiện `error`.

Chrome nêu đúng nguyên nhân, Safari thì không. Cả 2 trình duyệt đều chạy tệp với `type="module"`. Script từ một origin khác chỉ cho `Script error.`, không có tên tệp và ở dòng 0, vì trình duyệt ẩn chi tiết của script từ origin khác.

Node.js 22.18.0 chỉ báo lỗi với `"type": "commonjs"`. Khi không có trường `type`, nó chạy tệp và in ra cảnh báo bên dưới.

Kết quả

```text
poured IPA
(node:37250) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///…/app.js is not specified and it doesn't parse as CommonJS.
Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
To eliminate this warning, add "type": "module" to /…/package.json.
```

|  | Chrome 157 | Safari 27.2 |
| --- | --- | --- |
| `<script src>` không có kiểu | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `<script>` nội tuyến không có kiểu | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` có `export`, thẻ cổ điển | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` từ origin khác | `Script error.` | `Script error.` |
| `<script type="module">` | Đã chạy | Đã chạy |

## Vì sao script cổ điển không dùng được import

Trang MDN về lỗi này nói rằng câu khai báo `import` chỉ được đặt ở cấp cao nhất của một module, và nguyên nhân thường gặp là tệp không chạy như module. Trình duyệt chỉ đọc một tệp như module khi thẻ của nó có `type="module"`. Không có kiểu, trình duyệt phân tích tệp như script cổ điển và dừng ở câu `import` đầu tiên.

Script cổ điển được dùng lệnh gọi hàm `import()`. Thông báo của Safari nói về lệnh gọi này, nên nó báo thiếu đối số chứ không báo thiếu module.

Node.js quyết định riêng cho từng tệp. Nó xem phần mở rộng của tệp trước, rồi đến trường `type` của `package.json` gần nhất. Theo tài liệu Node.js, từ v22.7.0 và v20.19.0, một tệp không có trường `type` mà không phân tích được như CommonJS sẽ chạy như module.

nodejs/node#39353 đề nghị vào năm 2021 rằng Node.js nên chọn theo entry point chứ không theo `package.json`. Đề xuất này đã đóng vào năm 2022. Đặt `type` hoặc dùng `.mjs` vẫn giúp lựa chọn rõ ràng, và bỏ được cảnh báo.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. Phát hiện cú pháp, khi không có trường `type`

- [nodejs/node#39353](https://github.com/nodejs/node/issues/39353) Detect require vs. import based on the entry point, not package.json. Đã đóng, 45 bình luận.

## LogBrew ghi nhận những gì

SDK ghi nhận mỗi lỗi phân tích cú pháp thành 1 vấn đề tên `Browser error: SyntaxError`, với khóa gom nhóm `browser.error:SyntaxError`. Vấn đề có đường dẫn tệp và dòng, không có stack frame nào, và thông báo là `redacted`, vì SDK không gửi thông báo lỗi.

Lỗi import và export từ cả 2 trình duyệt đều vào cùng vấn đề đó, vì khóa chỉ chứa kiểu lỗi. Trường `sourcePath` cho bạn biết cần sửa tệp nào. Script từ origin khác thành một vấn đề riêng, `Browser error: Error`, ở dòng 0 và không có đường dẫn tệp.

Khi SDK nằm trong script module, LogBrew không ghi nhận gì cho cùng trang đó. Hãy tải SDK trong script cổ điển trước mã của bạn, như ở bước cuối.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Stack frame: 0
  - Khóa gom nhóm: `browser.error:SyntaxError`
  - Thông điệp: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Khóa gom nhóm: `browser.error:Error`

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

### Cannot use import statement outside a module nghĩa là gì?

Tệp có câu khai báo `import`, nhưng đã chạy như script cổ điển trong trình duyệt hoặc như CommonJS trong Node.js. Hãy tải tệp như module để sửa lỗi.

### Sửa lỗi này trong trình duyệt thế nào?

Thêm `type="module"` vào thẻ script tải tệp. Trong thử nghiệm của chúng tôi, cùng tệp `app.js` sau đó đã chạy trong Chrome 157 và Safari 27.2.

### Sửa lỗi này trong Node.js thế nào?

Đặt `"type": "module"` trong `package.json`, hoặc đổi tên tệp thành `.mjs`. Từ v22.7.0, Node.js cũng phát hiện cú pháp module trong gói không có trường `type` và in ra cảnh báo.

### Vì sao Safari hiện một lỗi khác?

Safari 27.2 báo `Unexpected token '{'. import call expects one or two arguments.` cho cùng tệp. Đó là cùng một vấn đề, với cùng cách sửa.

### Unexpected token export nghĩa là gì?

Script cổ điển cũng không dùng được `export`. Chrome báo `Unexpected token 'export'`, còn Safari báo `Unexpected keyword 'export'`. Hãy tải cả tệp đó như module.

## Thấy mọi script không phân tích được

SDK trình duyệt của LogBrew ghi nhận mỗi lỗi phân tích cú pháp kèm tệp và dòng, gom nhóm theo kiểu lỗi. Bắt đầu với gói miễn phí rộng rãi, không cần thẻ.

[Bắt đầu miễn phí](https://logbrew.co/vi)

## Nguồn

- [MDN, SyntaxError: import declarations may only appear at top level of a module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/import_decl_module_top_level)
- [MDN, Using modules on the web](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules/Modules_on_the_web)
- [Node.js docs, Determining module system](https://nodejs.org/api/packages.html#determining-module-system)
- [nodejs/node#39353](https://github.com/nodejs/node/issues/39353)

## Thêm cách sửa lỗi

- [Sửa lỗi Script error khiến thông điệp, file và số dòng bị ẩn](https://logbrew.co/vi/errors/script-error)
- [Sửa lỗi Failed to fetch và phân biệt 3 nguyên nhân](https://logbrew.co/vi/errors/failed-to-fetch)
- [Sửa java.lang.NullPointerException trong Kotlin và Android từ thông điệp của nó](https://logbrew.co/vi/errors/nullpointerexception)
- [Sửa Minified React error #418 và #185 từ thông điệp đầy đủ và dòng mã của bạn](https://logbrew.co/vi/errors/minified-react-error)
- [Sửa AxiosError Network Error và tìm xem bạn gặp nguyên nhân nào trong 3](https://logbrew.co/vi/errors/axios-network-error)
- [Sửa lỗi HTTP 499 và tìm xem ai đã ngừng chờ](https://logbrew.co/vi/errors/http-499)
- [Những lỗi chúng tôi đã tái hiện, và cách sửa từng lỗi](https://logbrew.co/vi/errors)
