ForHosting KIT · قراءة المواقع ومراقبتها

ترميز كيانات HTML المسماة وفك ترميزها

رمّز «Tom & Jerry <3 © 2026» لتحصل على «Tom & Jerry <3 © 2026» جاهزًا للإدراج في الشيفرة المصدرية للصفحة. وعند فك الترميز تعود الأسماء المعروفة إلى محارفها، ويُرفض الاسم المكتوب خطأً بدل أن يمر دون انتباه. مجانية في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

النص: Tom & Jerry <3 © 2026
وضع الحساب: Encode

تحصل على

النص: Tom & Jerry <3 © 2026

حوّل النص من كيانات HTML المسماة وإليها من دون تثبيت حزمة أو الاعتماد على DOM في المتصفح. يحمي وضع الترميز المحارف الحساسة للترميز، مثل علامة العطف والقوسين الزاويين وعلامات الاقتباس والفاصلة العليا، ويتعامل كذلك مع مجموعة عملية من الرموز وعلامات الترقيم الشائعة. يعيد وضع فك الترميز الكيانات المعروفة إلى محارفها، ويرفض الأسماء المجهولة بدل إبقاء خطأ محتمل بصمت.

رمّز النص قبل إدراجه في HTML

استخدم وضع الترميز عندما يلزم تمثيل نص عادي بأمان داخل مصدر HTML. قد تبدأ علامة العطف مرجع كيان، وقد يُفهم القوسان الزاويان على أنهما وسوم، كما قد تتداخل علامات الاقتباس مع البنية المحيطة بالقيمة. يستبدل المحوّل المحارف المدعومة بمراجع مسماة مثل <code>&amp;</code> و<code>&lt;</code> و<code>&gt;</code> و<code>&quot;</code> و<code>&apos;</code>.

ويتعرف أيضًا على محارف شائعة للعملات والملكية الفكرية والرياضيات وعلامات الترقيم والمسافات، ومنها حقوق النشر والعلامة التجارية المسجلة واليورو والمسافة غير المنقسمة والشرطات وعلامات الاقتباس المنحنية والنقاط والتعداد. يجري الترميز في مرور واحد، ولذلك لا تُرمّز علامات العطف التي أضافها التحويل مرة ثانية. تبقى الحروف والأرقام والمسافات والرموز التعبيرية والمحارف غير المدعومة كما هي.

تذكّر أن ترميز الكيانات خطوة لتمثيل النص، وليس تعقيمًا كاملًا لـ HTML؛ فهو لا يتحقق من صحة المستند، ولا يزيل الوسوم الخطرة، ولا يقرر ما إذا كانت القيمة آمنة في سياق JavaScript أو CSS أو URL.

فك ترميز الكيانات مع تحقق صارم

استخدم وضع فك الترميز عندما يحتوي الإدخال على مراجع مسماة وتحتاج إلى المحارف الأصلية للعرض أو المقارنة أو الفهرسة أو التصدير أو المعالجة اللاحقة. يُبحث عن كل مرجع مكتمل، يتكون من علامة عطف واسم وفاصلة منقوطة، في الجدول الثابت لهذه الإمكانية. تُستبدل الصيغ المعروفة بمحارف Unicode المقابلة مع الحفاظ على بقية السلسلة.

تميّز أسماء الكيانات بين الأحرف الكبيرة والصغيرة، لأن اختلاف حالة الأحرف قد يدل على معنى مختلف في HTML. يفيد هذا الرفض الصارم في المسارات الآلية، إذ لا يمر خطأ كتابي مثل <code>&copry;</code> بصمت ليظهر لاحقًا كنص تالف. تبقى علامة العطف العادية التي لا يتبعها اسم وفاصلة منقوطة على حالها.

تركز هذه الإمكانية عمدًا على الكيانات المسماة؛ أما مراجع المحارف الرقمية العشرية والسداسية العشرية فهي خارج هذا العقد. ويضمن جدول التحويل الثابت ألا تتغير النتيجة بحسب إصدار المتصفح أو حزمة خارجية أو الشبكة أو الإعدادات المحلية.

اختر الوضع وادمج النتيجة

أرسل حقلين: يحتوي <code>text</code> على السلسلة المصدر، وتكون قيمة <code>mode</code> إما <code>encode</code> أو <code>decode</code>. كلاهما مطلوب حتى لا يضطر أي تكامل إلى تخمين اتجاه التحويل. يعيد الرد قيمة <code>text</code> بعد تحويلها مع قيمة <code>mode</code> المطبقة، فتكون السجلات ومسارات العمل واضحة بذاتها.

في مسار الترميز، مرّر المحتوى الذي كتبه المستخدم قبل تضمينه في العلامات، ثم خزّن النص الناتج أو أرسله. وفي مسار فك الترميز، عامل الكيان المجهول على أنه فشل في التحقق وصحح الجهة المنتجة بدل تجاهل الخطأ. لا تستخدم الخوارزمية الشبكة أو العشوائية أو التاريخ أو حالة محفوظة، ولذلك تلائم الاختبارات المرجعية وتوليد المحتوى القابل للتكرار.

في الأنظمة الكبيرة، اجعل التحويل عند حد واضح: رمّز عند الدخول إلى تمثيل HTML، وفك الترميز فقط عند الخروج منه. يؤدي التبديل المتكرر بين الوضعين إلى غموض مسؤولية الهروب وقد يشجع على الترميز المزدوج غير المقصود.

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

تهيئة النص الظاهر للعلامات

حوّل علامات العطف والأقواس وعلامات الاقتباس والرموز الشائعة إلى مراجع مقروءة قبل إدراج النص في HTML مولّد.

توحيد نص HTML المستورد

فك المراجع المعروفة قبل مقارنة المحتوى أو البحث فيه أو تصديره أو تخزينه كنص Unicode عادي.

التحقق من مسارات المحتوى

أوقف المعالجة عندما تنتج جهة ما كيانًا مجهولًا، لتظهر الأخطاء الكتابية وأخطاء المطابقة مبكرًا.

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

ما الأوضاع المقبولة؟

يجب أن تكون القيمة <code>encode</code> أو <code>decode</code> بدقة. تؤدي أي قيمة أخرى إلى خطأ في الإدخال.

ماذا يحدث عند وجود كيان مجهول؟

يرفض وضع فك الترميز الطلب بخطأ إدخال يتضمن اسم الكيان المجهول.

هل يدعم فك الترميز مراجع المحارف الرقمية؟

لا. تعالج هذه الإمكانية كيانات HTML المسماة، وتترك المراجع العشرية والسداسية العشرية من دون تغيير.

هل ترميز الكيانات هو نفسه تعقيم HTML؟

لا. يحوّل الترميز المحارف المدعومة إلى مراجع نصية؛ ولا يحلل المستند أو يزيل الوسوم أو يحمي كل سياقات الإخراج.

ما المحارف التي تبقى كما هي عند الترميز؟

تبقى الحروف العادية والأرقام والمسافات والرموز التعبيرية والمحارف التي ليس لها اسم مدعوم كما هي. ولا يُستبدل إلا ما يؤثر في الترميز وبعض الرموز الشائعة، مثل علامة حقوق النشر وعلامة اليورو والشرطات وعلامات الاقتباس المنحنية وعلامة الحذف.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/web/html-entity-convert

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/web/html-entity-convert \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Tom & Jerry <3","mode":"encode"}'

const res = await fetch("https://api.kit.forhosting.com/web/html-entity-convert", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Tom & Jerry <3",
    "mode": "encode"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/html-entity-convert",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Tom & Jerry <3",
    "mode": "encode"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/html-entity-convert", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Tom & Jerry <3","mode":"encode"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Tom & Jerry <3","mode":"encode"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/html-entity-convert", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "Tom & Jerry <3",
  "mode": "encode"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.html_entity_convert",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

النتيجة حتمية وتناسب عمليات البناء القابلة للتكرار والاختبارات ومسارات المحتوى والقوالب وتكاملات API.

فك ترميز الكيانات مع تحقق صارم

إذا لم يكن المرجع المكتمل مدعومًا، يفشل الطلب بخطأ <code>invalid_input</code> يحدد الكيان المجهول.

اختر الوضع وادمج النتيجة

تبلغ كلفة طلب API ‏$0.002، بينما يمكن لتجربة المتصفح تشغيل المنطق النقي نفسه محليًا.

أسئلة تقنية

كم تبلغ كلفة طلب API؟

تبلغ كلفة كل طلب API ‏$0.002. يستخدم التحويل عنصرًا واحدًا بوصفه وحدة الفوترة.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

رمّز النص قبل إدراجه في HTML

فك ترميز الكيانات مع تحقق صارم

اختر الوضع وادمج النتيجة

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

تهيئة النص الظاهر للعلامات

توحيد نص HTML المستورد

التحقق من مسارات المحتوى

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

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

فك ترميز الكيانات مع تحقق صارم

اختر الوضع وادمج النتيجة

أسئلة تقنية

شكرًا