ForHosting KIT · أدوات المطورين

منسق JavaScript

تحوّل أداة تنسيق JavaScript الشفرة المضغوطة أو غير المتسقة في مسافاتها إلى صيغة أسهل للفحص والشرح والمراجعة.

● Betaمجاني · داخل متصفحك

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

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

أعد الوضوح إلى JavaScript المضغوط

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

احمِ السلاسل والتعليقات والقوالب والتعبيرات النمطية

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

اكتشف المحددات الناقصة قبل الخطوة التالية

يُطلب التنسيق كثيراً بعد نسخ الشفرة من موضع غير ملائم، وقد تؤدي عملية النسخ إلى إسقاط محرف من البداية أو النهاية. تحتفظ الأداة بمكدس متداخل للمحددات البنيوية وتقارن كل علامة إغلاق بعلامة الفتح الموافقة. يؤدي ظهور قوس دائري أو مربع أو معقوف مغلق على نحو غير متوقع إلى خطأ إدخال غير صالح فوراً. وإذا انتهى النص مع بقاء محدد مفتوح، تفشل العملية أيضاً بدلاً من إرجاع نتيجة تبدو مرتبة فقط. تُعامل المحددات الموجودة داخل السلاسل والتعليقات وقوالب النص والتعبيرات النمطية المحمية بوصفها محتوى. هذا الفحص محدود عمداً: لا يثبت توازن المحددات أن المعرّفات أو العوامل أو التعريفات أو صياغة الوحدات أو تدفق التحكم تمثل JavaScript صالحاً، ولا تشغّل الأداة الشفرة لاختبارها. لكنه يقدم تنبيهاً مهماً إلى حالات الاقتطاع وعدم التطابق الشائعة قبل إدخال المقطع في وثائق أو مراجعة أو مقارنة أو محلل متخصص. يمكن إجراء التنسيق محلياً في المتصفح، بينما تستخدم طلبات API المؤتمتة السعر الأساسي المنشور وقدره $0.002 لكل عنصر.

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

فحص مورد متصفح مصغّر

وسّع نصاً برمجياً مضغوطاً إلى كتل ذات مسافات بادئة وأسطر عبارات قبل تتبع دالة أو معالج أحداث أو استدعاء مريب.

إعداد مقطع للمراجعة

طبّق تخطيطاً حتمياً على JavaScript المولّد أو غير المتسق لكي تركز المراجعة على السلوك والبنية.

التحقق من مقطع منسوخ

اكتشف الأقواس الدائرية والمربعة والمعقوفة الناقصة أو غير المتطابقة قبل وضع الشفرة في وثائق أو أداة أخرى.

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

ما التنسيق الذي تطبقه الأداة؟

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

هل تشغّل الأداة شفرة JavaScript المقدّمة؟

لا. فهي تمسح النص بطريقة حتمية ولا تقيّم الشفرة المقدّمة أو تشغّلها مطلقاً.

هل تُحفظ السلاسل والتعليقات والقوالب والتعبيرات النمطية؟

نعم. يبقى محتواها محمياً من الفواصل البنيوية أثناء معالجة الماسح للشفرة المحيطة.

هل يضمن توازن العلامات صلاحية JavaScript؟

لا. تتحقق الأداة من المحددات وحدود التنسيق، لكنها لا تتحقق من صياغة ECMAScript كاملة.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/dev2/beautify-js

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

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

curl -X POST https://api.kit.forhosting.com/dev2/beautify-js \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"javascript":"function greet(name){const message=`Hello, ${name}!`;console.log(message);return message;}"}'

const res = await fetch("https://api.kit.forhosting.com/dev2/beautify-js", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "javascript": "function greet(name){const message=`Hello, ${name}!`;console.log(message);return message;}"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev2/beautify-js",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "javascript": "function greet(name){const message=`Hello, ${name}!`;console.log(message);return message;}"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/beautify-js", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"javascript":"function greet(name){const message=`Hello, ${name}!`;console.log(message);return message;}"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"javascript":"function greet(name){const message=`Hello, ${name}!`;console.log(message);return message;}"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/beautify-js", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "javascript": "function greet(name){const message=`Hello, ${name}!`;console.log(message);return message;}"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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