مسح موقع الويب

يقوم الأمر scan بجلب عنوان URL عام، وقياس الحجم الإجمالي للصفحة، وتدقيق صحة i18n و SEO للصفحة. ينتج عنه تقرير بنقاط (0-100) يغطي سمات HTML، والروابط الأساسية، وعلامات hreflang، و robots.txt، و sitemap.xml، والروابط الداخلية المترجمة، ووزن اللغة لحزمة JavaScript.

لا توجد تبعيات إضافية مطلوبة. عندما يكون puppeteer مثبتًا، يمكن للمسح التقاط أجزاء JavaScript التي يتم تحميلها بشكل كسول (lazy-loaded) لتحليل حزمة أكثر دقة؛ وإلا فإنه يتراجع عن فحص البرامج النصية المحملة بلهفة المعلن عنها في HTML.

الاستخدام

npx intlayer scan <url>

مثال

npx intlayer scan https://example.com

نموذج المخرجات:

🔍 Scanned https://example.com (basic mode)Score: 90/100Page size: 10.60 MB (HTML 42.31 KB)Locales: en, fr, es, de, …Checks:  ✓ html lang attribute  ✓ html dir attribute  ✓ canonical link  ✓ hreflang tags  ✓ x-default hreflang  ✓ localized internal links  ⚠ all internal links localized  ✓ current locale detected  ✓ robots.txt present  ✓ robots.txt keeps locale paths crawlable  ✓ sitemap.xml present  ✓ sitemap lists every locale  ✓ sitemap has alternate links  ✓ sitemap has x-defaultBundle locale weight:  Translations shipped: 120.50 KB  Unused (other locales): 45.20 KB (37%)

الخيارات

<url> (مطلوب)

عنوان URL المؤهل بالكامل للمسح (على سبيل المثال https://example.com).

--no-deep

تعطيل المسح العميق القائم على العرض.

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

قم بتمرير --no-deep لفرض الوضع الأساسي حتى عند توفر puppeteer.

مثال: npx intlayer scan https://example.com --no-deep

--json

إخراج نتيجة المسح الكاملة ككائن JSON بدلاً من تقرير منسق. مفيد للاستهلاك البرمجي أو خطوط أنابيب CI.

مثال: npx intlayer scan https://example.com --json

خيارات التكوين القياسية

• --base-dir — الدليل الأساسي المستخدم لتحديد موقع ملف intlayer.config.*.
• -e, --env — البيئة المستهدفة (على سبيل المثال development ، production).
• --env-file — المسار إلى ملف .env مخصص.
• --no-cache — تعطيل ذاكرة التخزين المؤقت للتكوين.
• --verbose — تمكين التسجيل التفصيلي (افتراضي في وضع CLI).
• --prefix — بادئة تسجيل مخصصة.

ما يتم فحصه

النتيجة النهائية هي المجموع الموزون لجميع الفحوصات الناجحة معبرًا عنها بنسبة مئوية (0-100).

استخدام وظيفة المسح برمجياً

يتم تصدير وظيفة scan أيضًا من @intlayer/cli بحيث يمكن استدعاؤها من البرامج النصية الخاصة بك:

import { scan } from "@intlayer/cli";await scan("https://example.com", {  deep: false,  json: false,});

للوصول إلى مستوى أدنى ، يعيد scanWebsite من @intlayer/chokidar/scan كائن ScanResult مهيكل:

import { scanWebsite } from "@intlayer/chokidar/scan";const result = await scanWebsite("https://example.com", { deep: false });console.log(result.score, result.totalPageSize, result.events);