كيفية العمل مع عناوين URL في Python
طبقة URL في Aspose.HTML FOSS لـ Python تنفّذ التحليل على نمط WHATWG، لذا فإن عناوين URL الموجودة في المستندات تُحلّ وتُطبع بالطريقة التي تتعامل بها المتصفحات معها. يغطي هذا الدليل التحليل، والتحقق، وسلاسل الاستعلام، ونموذج الفشل، باستخدام pip للتثبيت.
دليل خطوة بخطوة
الخطوة 1: تثبيت الحزمة
git clone https://github.com/aspose-html-foss/Aspose.HTML-FOSS-for-Python.git
cd Aspose.HTML-FOSS-for-Python
pip install -e .الخطوة 2: استيراد الفئات المطلوبة
from aspose_html.url import URL, URLSearchParamsالخطوة 3: التحليل والتحقق
URL.parse() يحلّل عناوين URL المطلقة أو النسبية (مع قاعدة); URL.can_parse() يجيب عن الصلاحية بطريقة قليلة التكلفة دون إنشاء كائن؛ فشل التحليل يثير URLParseError المكتوب.
الخطوة 4: تحرير سلاسل الاستعلام
URLSearchParams يعيد معلمات الاستعلام — append()، get()، get_all()، has()، وdelete() — مع الحفاظ على دلالة القيم المتعددة للمفاتيح المتكررة.
المشكلات الشائعة والحلول
فشل تحليل عنوان URL نسبي. تحليل النسبي يحتاج إلى عنوان URL أساسي — قدم واحدًا إلى URL.parse().
يتم إرجاع القيمة الأولى فقط من مفتاح مكرر. get() يرجع التطابق الأول وفق التصميم؛ استخدم get_all() لكل قيمة.
تظهر المكوّنات كأنها مُعَدلَة أو مُشفّرة بنسبة مئوية بشكل غير متوقع. تطبيع WHATWG قيد العمل — الناتج يتطابق مع سلوك المتصفح.
الأسئلة المتكررة
كيف يمكنني التحقق من صحة عنوان URL دون تحليله؟
URL.can_parse() يعيد قيمة منطقية دون إنشاء كائن.
هل مفاتيح الاستعلام حساسة لحالة الأحرف؟
نعم — يتم مطابقة المفاتيح كما هي، متسقة مع معيار URL.
ما نوع الخطأ الذي تطرحه فشل التحليل؟
المُعَرَّف URLParseError — امسك به بدلاً من التحقق المسبق باستخدام التعابير النمطية.
