استخدام CLI لـ bun run

bun run <file or script>

خيارات التنفيذ العامة

--silentboolean

عدم طباعة أمر النص البرمجي

--if-presentboolean

الخروج بدون خطأ إذا لم يكن نقطة الدخول موجودة

--evalstring

تقييم الوسيطة كنص برمجي. الاختصار: -e

--printstring

تقييم الوسيطة كنص برمجي وطباعة النتيجة. الاختصار: -p

--helpboolean

عرض هذه القائمة والخروج. الاختصار: -h

إدارة مساحة العمل

--elide-linesnumber default: 10

عدد أسطر إخراج النص البرمجي المعروضة عند استخدام --filter (الافتراضي: 10). اضبط على 0 لعرض جميع الأسطر

--filterstring

تشغيل نص برمجي في جميع حزم مساحة العمل المطابقة للنمط. الاختصار: -F

--workspacesboolean

تشغيل نص برمجي في جميع حزم مساحة العمل (من حقل workspaces في package.json)

التحكم في وقت التنفيذ والعملية

--bunboolean

فرض استخدام نص أو حزمة لوقت تشغيل Bun بدلاً من Node.js (عبر ربط node رمزياً). الاختصار: -b

--shellstring

التحكم في الغلاف المستخدم لنصوص package.json البرمجية. يدعم إما bun أو system

--smolboolean

استخدام ذاكرة أقل، ولكن تشغيل تجميع القمامة بشكل أكثر تكرارًا

--expose-gcboolean

تعريض gc() على الكائن العام. ليس له تأثير على Bun.gc()

--no-deprecationboolean

قمع جميع تقارير الإلغاء المخصص

--throw-deprecationboolean

تحديد ما إذا كانت تحذيرات الإلغاء تؤدي إلى أخطاء

--titlestring

تعيين عنوان العملية

--zero-fill-buffersboolean

قيمة منطقية لفرض ملء Buffer.allocUnsafe(size) بالأصفار

--no-addonsboolean

طرح خطأ إذا تم استدعاء process.dlopen، وتعطيل شرط التصدير node-addons

--unhandled-rejectionsstring

واحدة من strict أو throw أو warn أو none أو{" "} warn-with-error-code

--console-depthnumber default: 2

تعيين العمق الافتراضي لفحص كائن console.log (الافتراضي: 2)

سير عمل التطوير

--watchboolean

إعادة تشغيل العملية تلقائيًا عند تغيير الملف

--hotboolean

تمكين إعادة التحميل التلقائي في وقت تشغيل Bun أو مُشغل الاختبار أو المجمع

--no-clear-screenboolean

تعطيل مسح شاشة الطرفية عند إعادة التحميل عند تمكين --hot أو --watch

التصحيح

--inspectstring

تفعيل مصحح الأخطاء في Bun

--inspect-waitstring

تفعيل مصحح الأخطاء في Bun، انتظار الاتصال قبل التنفيذ

--inspect-brkstring

تفعيل مصحح الأخطاء في Bun، تعيين نقطة توقف على السطر الأول من الكود والانتظار

حل التبعيات والوحدات

--preloadstring

استيراد وحدة قبل تحميل الوحدات الأخرى. الاختصار: -r

--requirestring

مرادف لـ --preload، لتوافق Node.js

--importstring

مرادف لـ --preload، لتوافق Node.js

--no-installboolean

تعطيل التثبيت التلقائي في وقت تشغيل Bun

--installstring default: auto

تكوين سلوك التثبيت التلقائي. واحدة من auto (الافتراضي، التثبيت التلقائي عند عدم وجود node_modules)،{" "} fallback (الحزم المفقودة فقط)، force (دائمًا)

-iboolean

تثبيت التبعيات تلقائيًا أثناء التنفيذ. يعادل --install=fallback

--prefer-offlineboolean

تخطي فحوصات القدم للحزم في وقت تشغيل Bun والحل من القرص

--prefer-latestboolean

استخدام أحدث الإصدارات المطابقة للحزم في وقت تشغيل Bun، والتحقق دائمًا من npm

--conditionsstring

تمرير شروط مخصصة للحل

--main-fieldsstring

الحقول الرئيسية للبحث في package.json. الافتراضي يعتمد على --target

--preserve-symlinksboolean

الحفاظ على الروابط الرمزية عند حل الملفات

--preserve-symlinks-mainboolean

الحفاظ على الروابط الرمزية عند حل نقطة الدخول الرئيسية

--extension-orderstring default: .tsx,.ts,.jsx,.js,.json

الافتراضي: .tsx,.ts,.jsx,.js,.json

التحويل وميزات اللغة

--tsconfig-overridestring

تحديد tsconfig.json مخصص. الافتراضي $cwd/tsconfig.json

--definestring

استبدال K:V أثناء التحليل، مثل --define process.env.NODE_ENV:"development". يتم تحليل القيم كـ JSON. الاختصار: -d

--dropstring

إزالة استدعاءات الدوال، مثل --drop=console يزيل جميع استدعاءات console.*

--loaderstring

تحليل الملفات مع .ext:loader، مثل --loader .js:jsx. المحملات الصالحة: js،{" "} jsx، ts، tsx، json، toml، text،{" "} file، wasm، napi. الاختصار: -l

--no-macroboolean

تعطيل تنفيذ الماكرو في المجمع والمحول ووقت التشغيل

--jsx-factorystring

تغيير الدالة المستدعاة عند تجميع عناصر JSX باستخدام وقت تشغيل JSX الكلاسيكي

--jsx-fragmentstring

تغيير الدالة المستدعاة عند تجميع أجزاء JSX

--jsx-import-sourcestring default: react

يعلن عن محدد الوحدة المراد استخدامه لاستيراد دوال المصنع jsx و jsxs. الافتراضي: react

--jsx-runtimestring default: automatic

automatic (الافتراضي) أو classic

--jsx-side-effectsboolean

معاملة عناصر JSX على أن لها آثارًا جانبية (تعطيل تعليقات pure)

--ignore-dce-annotationsboolean

تجاهل تعليقات إزالة الكود الميت مثل @__PURE__

الشبكة والأمان

--portnumber

تعيين المنفذ الافتراضي لـ Bun.serve

--fetch-preconnectstring

الاتصال المسبق بعنوان URL أثناء تحميل الكود

--max-http-header-sizenumber default: 16384

تعيين الحد الأقصى لحجم ترويسات HTTP بالبايت. الافتراضي هو 16KiB

--dns-result-orderstring default: verbatim

تعيين الترتيب الافتراضي لنتائج بحث DNS. الأوامر الصالحة: verbatim (الافتراضي)، ipv4first،{" "} ipv6first

--use-system-caboolean

استخدام سلطات الشهادات الموثوقة للنظام

--use-openssl-caboolean

استخدام مخزن CA الافتراضي لـ OpenSSL

--use-bundled-caboolean

استخدام مخزن CA المجمع

--redis-preconnectboolean

الاتصال المسبق بـ $REDIS_URL عند بدء التشغيل

--sql-preconnectboolean

الاتصال المسبق بـ PostgreSQL عند بدء التشغيل

--user-agentstring

تعيين ترويسة User-Agent الافتراضية لطلبات HTTP

التكوين العام والسياق

--env-filestring

تحميل متغيرات البيئة من الملف (الملفات) المحددة

--cwdstring

المسار المطلق لحل الملفات ونقاط الدخول منه. هذا يغير فقط cwd للعملية

--configstring

تحديد مسار ملف تكوين Bun. الافتراضي $cwd/bunfig.toml. الاختصار: -c

أمثلة

تشغيل ملف JavaScript أو TypeScript:

bun run ./index.js
bun run ./index.tsx

تشغيل نص package.json:

bun run dev
bun run lint