---

title: Hono - إطار ويب مبني على معايير الويب titleTemplate: ':title'

Hono

Hono - تعني اللهب 🔥 باليابانية - هو إطار عمل ويب صغير وبسيط وفائق السرعة مبني على معايير الويب. يعمل على أي وقت تشغيل JavaScript: Cloudflare Workers، Fastly Compute، Deno، Bun، Vercel، Netlify، AWS Lambda، Lambda@Edge، و Node.js.

سريع، وليس سريعًا فحسب.

import { Hono } from 'hono'
const app = new Hono()

app.get('/', (c) => c.text('Hono!'))

export default app

البدء السريع

شغّل هذا فقط:

npm create hono@latest

yarn create hono

pnpm create hono@latest

bun create hono@latest

deno init --npm hono@latest

الميزات

• فائق السرعة 🚀 - الموجّه RegExpRouter سريع حقًا. لا يستخدم حلقات خطية. سريع.
• خفيف 🪶 - الـ hono/tiny القالب الجاهز (preset) أقل من 14kB. لا يمتلك Hono أي تبعيات (dependencies) ولا يستخدم سوى معايير الويب.
• متعدد أوقات التشغيل (Multi-runtime) 🌍 - يعمل على Cloudflare Workers و Fastly Compute و Deno و Bun و AWS Lambda أو Node.js. نفس الكود يعمل على جميع المنصات.
• بطاريات مشمولة (Batteries Included) 🔋 - يمتلك Hono وسائط مدمجة ووسائط مخصصة ووسائط خارجية وأدوات مساعدة. كل شيء مشمول.
• تجربة مطور ممتعة (DX) 😃 - واجهات API نظيفة للغاية. دعم TypeScript من الدرجة الأولى. الآن، لدينا "الأنواع".

حالات الاستخدام

Hono هو إطار عمل بسيط لتطبيقات الويب يشبه Express، دون واجهة أمامية (frontend). لكنه يعمل على حواف CDN (CDN Edges) ويتيح لك بناء تطبيقات أكبر عند دمجه مع الوسائط. فيما يلي بعض الأمثلة على حالات الاستخدام.

• بناء واجهات برمجة تطبيقات الويب
• وكيل لخوادم الواجهة الخلفية
• أمام CDN
• تطبيق Edge
• خادم أساسي لمكتبة
• تطبيق متكامل (full-stack)

من يستخدم Hono؟

المشروع (Project)	المنصة (Platform)	الغرض (What for?)
cdnjs	Cloudflare Workers	خدمة CDN مجانية ومفتوحة المصدر. يُستخدم Hono لخادم API.
Cloudflare D1	Cloudflare Workers	قواعد بيانات SQL بدون خادم (Serverless). يُستخدم Hono لخادم API الداخلي.
Cloudflare Workers KV	Cloudflare Workers	قاعدة بيانات قيم-مفاتيح بدون خادم (key-value). يُستخدم Hono لخادم API الداخلي.
BaseAI	Local AI Server	خطوط أنابيب (pipes) لوكيل AI بدون خادم مع ذاكرة. إطار عمل وكلاء AI مفتوح المصدر للويب. خادم API مع Hono.
Unkey	Cloudflare Workers	مصادقة وتفويض (authentication and authorization) مفتوح المصدر لواجهات API. يُستخدم Hono لخادم API.
OpenStatus	Bun	منصة مراقبة مواقع وواجهات API مفتوحة المصدر. يُستخدم Hono لخادم API.
اختبارات أداء Deno	Deno	وقت تشغيل TypeScript آمن مبني على V8. يُستخدم Hono للقياس (benchmarking).
Clerk	Cloudflare Workers	منصة إدارة مستخدمين مفتوحة المصدر. يُستخدم Hono لخادم API.
PostHog	Node.js	المنصة مفتوحة المصدر لبناء منتجات ذاتية القيادة. يُستخدم Hono لخادم MCP.

وما يلي.

• Drivly - Cloudflare Workers
• repeat.dev - Cloudflare Workers

هل تريد رؤية المزيد؟ انظر من يستخدم Hono في بيئة الإنتاج؟.

Hono في دقيقة واحدة

عرض توضيحي لإنشاء تطبيق لـ Cloudflare Workers باستخدام Hono.

فائق السرعة

Hono هو الأسرع، مقارنةً بالموجّهات (routers) الأخرى لـ Cloudflare Workers.

Hono x 402,820 ops/sec ±4.78% (80 runs sampled)
itty-router x 212,598 ops/sec ±3.11% (87 runs sampled)
sunder x 297,036 ops/sec ±4.76% (77 runs sampled)
worktop x 197,345 ops/sec ±2.40% (88 runs sampled)
Fastest is Hono
✨  Done in 28.06s.

انظر المزيد من اختبارات الأداء.

خفيف الوزن

Hono صغير جدًا. مع hono/tiny الإعداد المسبق (preset)، حجمه أقل من 14KB عند التصغير (minified). هناك العديد من الوسائط والمحولات (adapters)، لكنها تُدمج في الحزمة فقط عند استخدامها. للسياق، حجم Express هو 572KB.

$ npx wrangler dev --minify ./src/index.ts
 ⛅️ wrangler 2.20.0
--------------------
⬣ Listening at http://0.0.0.0:8787
- http://127.0.0.1:8787
- http://192.168.128.165:8787
Total Upload: 11.47 KiB / gzip: 4.34 KiB

موجّهات متعددة

لدى Hono عدة موجّهات.

RegExpRouter هو أسرع موجه (router) في عالم JavaScript. يطابق المسار باستخدام Regex كبير واحد يُنشأ قبل التوزيع (dispatch). مع SmartRouter، يدعم جميع أنماط المسارات.

LinearRouter يسجل المسارات بسرعة كبيرة، لذا فهو مناسب لبيئة تهيئ التطبيقات في كل مرة. PatternRouter ببساطة يضيف النمط ويطابقه، مما يجعله صغيرًا.

انظر مزيد من المعلومات حول المسارات.

معايير الويب

بفضل استخدام معايير الويب (Web Standards)، يعمل Hono على الكثير من المنصات.

• Cloudflare Workers
• Fastly Compute
• Deno
• Bun
• Vercel
• AWS Lambda
• Lambda@Edge
• أخرى

وباستخدام مُهايئ Node.js، يعمل Hono على Node.js.

انظر مزيد من المعلومات حول معايير الويب (Web Standards).

البرمجيات الوسيطة والمساعدات

يمتلك Hono العديد من الوسائط (middleware) والأدوات المساعدة. وهذا يجعل "اكتب أقل، أنجز أكثر" حقيقة واقعة.

من دون إعداد إضافي، يوفّر Hono وسيطات (middleware) ومساعدات (helpers) لـ:

• المصادقة الأساسية
• مصادقة Bearer
• حدّ حجم الجسم (Body Limit)
• التخزين المؤقت
• الضغط (Compress)
• تخزين السياق
• Cookie
• CORS
• ETag
• html
• JSX
• مصادقة JWT
• Logger
• اللغة
• JSON مُنسَّق (Pretty JSON)
• الترويسات الآمنة
• SSG
• البث
• خادم GraphQL
• مصادقة Firebase
• Sentry
• أخرى!

على سبيل المثال، إضافة ETag وتسجيل الطلبات لا يتطلب سوى بضعة أسطر من الكود باستخدام Hono:

import { Hono } from 'hono'
import { etag } from 'hono/etag'
import { logger } from 'hono/logger'

const app = new Hono()
app.use(etag(), logger())

انظر مزيد من المعلومات حول البرمجيات الوسيطة (Middleware).

تجربة المطوّر

يوفّر Hono "تجربة مطوّر" (Developer Experience) ممتعة.

وصول سهل إلى Request/Response بفضل Context كائن. علاوةً على ذلك، Hono مكتوب بـ TypeScript. يمتلك Hono "أنواعاً" (Types).

على سبيل المثال، ستكون معاملات المسار (path parameters) من أنواع حرفية (literal types).

و، المدقّق (Validator) وعميل Hono hc تفعيل وضع RPC. في وضع RPC، يمكنك استخدام أداة التحقق (validator) المفضلة لديك مثل Zod ومشاركة مواصفات واجهة API من جانب الخادم مع العميل بسهولة وبناء تطبيقات آمنة من حيث الأنواع (type-safe).

انظر Hono Stacks.