---
title: "حل خطأ Cannot use import statement outside a module في المتصفح وفي Node.js"
description: "يعني SyntaxError: Cannot use import statement outside a module أن الملف عمل كسكربت كلاسيكي أو كـ CommonJS. حمّله كوحدة، فتعمل عبارة import نفسها."
canonical: "https://logbrew.co/ar/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# حل خطأ Cannot use import statement outside a module في المتصفح وفي Node.js

يعني `SyntaxError: Cannot use import statement outside a module` أن الملف عمل كسكربت كلاسيكي أو كـ CommonJS. حمّله كوحدة، فتعمل عبارة `import` نفسها.

اختُبر في 21 نوفمبر 2026 باستخدام Chrome 157 وSafari 27.2 وNode.js 22.18.0 و@logbrew/browser 0.1.22

بقلم [Furkan Erday](https://github.com/furkanerday). Furkan Erday مؤسس LogBrew، ويبني LogBrew كل يوم باستخدام Claude Code وCodex.

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

## ماذا فعلت 5 وسوم script بعبارة `import` واحدة

| كيف حمّلته الصفحة | عمل الكود | مشكلة في LogBrew |
| --- | --- | --- |
| `<script src>` بلا نوع | لا | `SyntaxError` |
| `<script>` مضمّن | لا | `SyntaxError` |
| `<script src>` من أصل آخر | لا | `Error`، السطر 0 |
| SDK في سكربت `type="module"` | لا | لا |
| `<script type="module">` | نعم | لا خطأ |

أعطى Chrome 157 وSafari 27.2 النتيجة نفسها لكل وسم.

## اعرف أين عمل الملف كسكربت كلاسيكي

### افحص وسم script الذي يحمّل الملف

ليس للوسم السمة `type`، لذلك يقرأ المتصفح `app.js` كسكربت كلاسيكي، والسكربت الكلاسيكي لا يستطيع استخدام `import`. توقّف Chrome 157 عند السطر 1، العمود 1، قبل أن يعمل أي سطر من الملف. وأعطى سكربت مضمّن الرسالة نفسها.

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

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

pour("IPA");
```

المخرجات

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

### يعطي Safari رسالة مختلفة للملف نفسه

قرأ Safari 27.2 الملف `app.js` نفسه ورمى `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` تتحدث الرسالة عن استدعاء `import()` ولا تذكر الوحدات. السبب والحل هما نفسهما.

المخرجات

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

### عبارة export في سكربت كلاسيكي تفشل أيضًا

الملف الذي يصدّر فقط، إذا حمّله وسم كلاسيكي، يتوقف عند أول `export`. عرض Chrome الرسالة `Unexpected token 'export'` وعرض Safari الرسالة `Unexpected keyword 'export'`. كلاهما يعني أن الصفحة حمّلت وحدة كسكربت كلاسيكي.

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

المخرجات

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

### في Node.js، افحص الحقل type في package.json

رمى Node.js 22.18.0 الرسالة نفسها عندما احتوى `package.json` على `"type": "commonjs"`. يمر المكدّس عبر `wrapSafe` في محمّل CommonJS. ومن دون الحقل `type`، شغّل Node.js الملف كوحدة وطبع تحذيرًا بدل الخطأ.

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

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

المخرجات

```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)
```

## حمّل الملف كوحدة

### أضف نوع الوحدة إلى وسم script

مع `type="module"` على الوسم نفسه، عمل `app.js` وعبارة `import` فيه في Chrome 157 وSafari 27.2. عندها يحمّل المتصفح `tap.js` بنفسه. إذا كان وسم كلاسيكي يحمّل `tap.js` أيضًا، فاحذف ذلك الوسم، لأنه يظل يتوقف عند `export`.

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

### اضبط نوع الوحدة في package.json

ضع `"type": "module"` في `package.json`، أو غيّر اسم الملف إلى `.mjs`. شغّل الخياران ملفنا من دون تحذير. يقرأ Node.js الملف `.mjs` كوحدة والملف `.cjs` كـ CommonJS، أيًا كانت قيمة الحقل `type`.

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

// node app.js
```

المخرجات

```text
poured IPA
```

### حمّل SDK من LogBrew أولًا في سكربت كلاسيكي

يقع خطأ التحليل قبل أن يعمل أي سطر من ذلك الملف، لذلك يجب أن يكون مستمع الأخطاء على الصفحة مسبقًا. لا يشغّل المتصفح سكربت الوحدة إلا بعد أن يقرأ الصفحة، لذلك يأتي متأخرًا. مع SDK في سكربت كلاسيكي داخل `<head>` سجّل LogBrew الخطأ. ومع SDK في سكربت `type="module"` لم يسجّل شيئًا.

```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>
```

## ما رأيناه في الاختبار

قدّمنا صفحة واحدة على `http://127.0.0.1:28180` وفتحناها في Chrome 157 وSafari 27.2، مع تحميل `@logbrew/browser` 0.1.22 أولًا. حمّلنا الكود نفسه بـ 5 طرق، وقرأنا `error.message` من الحدث `error`.

ذكر Chrome السبب، ولم يذكره Safari. شغّل المتصفحان الملف مع `type="module"`. أعطى سكربت من أصل آخر `Script error.` فقط، بلا اسم ملف وعند السطر 0، لأن المتصفح يخفي تفاصيل السكربت القادم من أصل آخر.

أعطى Node.js 22.18.0 الخطأ فقط مع `"type": "commonjs"`. ومن دون الحقل `type` شغّل الملف وطبع التحذير أدناه.

المخرجات

```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>` بلا نوع | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `<script>` مضمّن بلا نوع | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` مع `export`، وسم كلاسيكي | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` من أصل آخر | `Script error.` | `Script error.` |
| `<script type="module">` | عمل | عمل |

## لماذا لا يستطيع السكربت الكلاسيكي استخدام import

تقول صفحة MDN عن هذا الخطأ إن تصريح `import` لا يأتي إلا في المستوى الأعلى من وحدة، وإن السبب المعتاد ملف لا يعمل كوحدة. لا يقرأ المتصفح الملف كوحدة إلا إذا كان لوسمه `type="module"`. ومن دون نوع يحلّله كسكربت كلاسيكي ويتوقف عند أول `import`.

يستطيع السكربت الكلاسيكي استخدام استدعاء الدالة `import()`. ورسالة Safari تتحدث عن هذا الاستدعاء، لذلك تبلّغ عن وسيط ناقص لا عن وحدة ناقصة.

يقرر Node.js لكل ملف على حدة. ينظر أولًا إلى امتداد الملف، ثم إلى الحقل `type` في أقرب `package.json`. ووفق توثيق Node.js، منذ v22.7.0 وv20.19.0 يعمل كوحدة كل ملف بلا الحقل `type` لا يمكن تحليله كـ CommonJS.

طلب nodejs/node#39353 في 2021 أن يختار Node.js بحسب نقطة الدخول لا بحسب `package.json`. وأُغلق الطلب في 2022. ضبط `type` أو استخدام `.mjs` ما زال يجعل الاختيار واضحًا، ويزيل التحذير.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. اكتشاف الصياغة، عند غياب الحقل `type`

- [nodejs/node#39353](https://github.com/nodejs/node/issues/39353) Detect require vs. import based on the entry point, not package.json. مغلق, 45 تعليقًا.

## ما يسجّله LogBrew

سجّل SDK كل خطأ تحليل كمشكلة واحدة باسم `Browser error: SyntaxError`، مع مفتاح التجميع `browser.error:SyntaxError`. كان في المشكلة مسار الملف والسطر، بلا إطارات مكدّس، والرسالة `redacted`، لأن SDK لا يرسل رسائل الأخطاء.

دخلت أخطاء import وexport من المتصفحين في المشكلة نفسها، لأن المفتاح لا يحمل إلا نوع الخطأ. يخبرك `sourcePath` أي ملف تصلح. وأصبح السكربت القادم من أصل آخر مشكلة منفصلة، `Browser error: Error`، عند السطر 0 وبلا مسار ملف.

مع SDK في سكربت وحدة، لم يسجّل LogBrew شيئًا للصفحة نفسها. حمّل SDK في سكربت كلاسيكي قبل كودك، كما في الخطوة الأخيرة.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - إطارات المكدّس: 0
  - مفتاح التجميع: `browser.error:SyntaxError`
  - الرسالة: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - مفتاح التجميع: `browser.error:Error`

## أسئلة شائعة

### ما معنى Cannot use import statement outside a module؟

في الملف تصريح `import`، لكنه عمل كسكربت كلاسيكي في المتصفح أو كـ CommonJS في Node.js. حمّله كوحدة لتصلح الخطأ.

### كيف أصلح الخطأ في المتصفح؟

أضف `type="module"` إلى وسم script الذي يحمّل الملف. في اختبارنا عمل `app.js` نفسه بعد ذلك في Chrome 157 وSafari 27.2.

### كيف أصلح الخطأ في Node.js؟

ضع `"type": "module"` في `package.json`، أو غيّر اسم الملف إلى `.mjs`. منذ v22.7.0 يكتشف Node.js أيضًا صياغة الوحدات في حزمة بلا الحقل `type` ويطبع تحذيرًا.

### لماذا يعرض Safari خطأ مختلفًا؟

أبلغ Safari 27.2 عن `Unexpected token '{'. import call expects one or two arguments.` للملف نفسه. إنها المشكلة نفسها، والحل نفسه.

### ما معنى Unexpected token export؟

لا يستطيع السكربت الكلاسيكي استخدام `export` أيضًا. عرض Chrome الرسالة `Unexpected token 'export'` وعرض Safari الرسالة `Unexpected keyword 'export'`. حمّل ذلك الملف كوحدة أيضًا.

## اعرف كل سكربت يفشل تحليله

يسجّل SDK المتصفح من LogBrew كل خطأ تحليل مع ملفه وسطره، مجمّعًا بحسب نوع الخطأ. ابدأ بخطة مجانية سخية دون بطاقة.

[ابدأ مجانًا](https://logbrew.co/ar)

## المصادر

- [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)

## المزيد من حلول الأخطاء

- [أصلح خطأ Script error الذي يخفي رسالته وملفه وسطره](https://logbrew.co/ar/errors/script-error)
- [أصلح خطأ Failed to fetch وميّز بين أسبابه الـ3](https://logbrew.co/ar/errors/failed-to-fetch)
- [أصلح java.lang.NullPointerException في Kotlin وAndroid من رسالته](https://logbrew.co/ar/errors/nullpointerexception)
- [أصلح Minified React error #418 و#185 من الرسالة الكاملة وسطر كودك](https://logbrew.co/ar/errors/minified-react-error)
- [حل AxiosError Network Error واعرف أي سبب من أسبابه الـ 3 لديك](https://logbrew.co/ar/errors/axios-network-error)
- [حل خطأ HTTP 499 واعرف من توقف عن الانتظار](https://logbrew.co/ar/errors/http-499)
- [أخطاء أعدنا إنتاجها، وكيف تصلح كلًا منها](https://logbrew.co/ar/errors)
