XML اور HTML دستاویزات کے لیے XPath ٹیسٹنگ
XPath ٹیسٹر ایک ایسا ٹول ہے جو آپ کو اپنے فراہم کردہ XML یا HTML مواد کے خلاف XPath ایکسپریشنز کا ٹیسٹ کرنے کی سہولت دیتا ہے۔ یہ ٹول آپ کے مواد کے ان تمام حصوں کو ظاہر کرتا ہے جو آپ کے ایکسپریشن سے مطابقت رکھتے ہیں۔ ان نتائج میں نوڈ کی قسم، نام، پاتھ اور ان کی ویلیو کا ایک پریویو شامل ہوتا ہے، جس کے بعد آپ کسی بھی انفرادی نتیجے کی ویلیو کو آسانی سے کاپی کر سکتے ہیں۔
یہ ٹول مکمل طور پر کلائنٹ سائیڈ پر کام کرتا ہے۔ آپ کا XML، HTML اور XPath کا ڈیٹا آپ کے اپنے براؤزر میں ٹیسٹ کیا جاتا ہے اور BroBroGo پر کچھ بھی اپ لوڈ نہیں کیا جاتا۔
ان پٹ کی اقسام اور ان کی حدود
ٹول میں درست تجزیہ اور پروسیسنگ کے لیے مخصوص حدود اور ان پٹ کے طریقے متعین ہیں:
- XML / HTML ان پٹ: آپ ٹیکسٹ مواد کو XML یا HTML فارمیٹ میں فراہم کر سکتے ہیں۔ اس ان پٹ کی زیادہ سے زیادہ حد 500,000 حروف ہے۔
- XPath ایکسپریشن: وہ پاتھ یا ایکسپریشن جس کا آپ ٹیسٹ کرنا چاہتے ہیں۔ اس کی زیادہ سے زیادہ حد 4,000 حروف ہے۔
- ان پٹ کی قسم: آپ اپنی دستاویز کی نوعیت کے لحاظ سے "XML" یا "HTML" کا انتخاب کر سکتے ہیں۔
اگر ان پٹ دستاویز بہت بڑی ہو تو ٹول پروسیسنگ روک دیتا ہے اور یہ پیغام ظاہر کرتا ہے:
"یہ دستاویز یہاں ٹیسٹ کرنے کے لیے بہت بڑی ہے۔ کوئی چھوٹا نمونہ آزمائیں۔"
اسی طرح، اگر آپ کا XPath ایکسپریشن مقررہ حد سے تجاوز کر جائے تو یہ پیغام ظاہر ہوتا ہے:
"یہ XPath ایکسپریشن یہاں ٹیسٹ کرنے کے لیے بہت لمبا ہے۔"
XML موڈ اور HTML موڈ میں فرق
دستاویزات کی ساخت اور ان کے قوانین کے مطابق ٹول دو مختلف موڈز پیش کرتا ہے:
| خصوصیت | XML موڈ | HTML موڈ |
|---|---|---|
| قوانین کی پابندی | XML نیم اسپیس کے قوانین کی سختی سے پیروی کی جاتی ہے۔ | لچکدار رویہ اپنایا جاتا ہے۔ |
| پاتھ کی ساخت | نیم اسپیس پریفکسز اور سخت ساخت لازمی ہو سکتی ہے۔ | سادہ پاتھ جیسے //a عام ٹیگز سے میچ کرنے کے لیے استعمال ہو سکتے ہیں۔ |
| نیم اسپیسز کا نفاذ | دستاویز میں ڈیکلیئر کردہ نیم اسپیسز لاگو ہوتی ہیں۔ | نیم اسپیسز کو نظر انداز کر کے عام ٹیگ میچنگ کی جاتی ہے۔ |
XML نیم اسپیسز کا استعمال
XML دستاویزات میں نیم اسپیسز (Namespaces) کا کردار اہم ہوتا ہے۔ اس ٹول میں:
- آپ کے XML میں ڈیکلیئر کردہ نیم اسپیس پریفکسز کو XPath میں استعمال کیا جا سکتا ہے، جیسے کہ
//x:item۔ - ڈیفالٹ نیم اسپیسز کے لیے،
//itemبھی دستاویز کے ڈیکلیئریشن کی پیروی کرتا ہے۔
اگر دستاویز کی ساخت درست نہ ہو اور اسے پارس نہ کیا جا سکے تو ٹول یہ غلطی ظاہر کرتا ہے:
"اس دستاویز کو پارس نہیں کیا جا سکا۔"
کارکردگی کی حدود اور ٹائم آؤٹ کے قوانین
براؤزر کو فعال اور جوابدہ رکھنے کے لیے ٹول میں کارکردگی کے سخت قوانین لاگو ہیں:
- دو سیکنڈ کی حد: ٹول کسی بھی XPath ایکسپریشن کا اندازہ لگانے کا عمل 2 سیکنڈ کے بعد روک دیتا ہے۔
- ایکسپریشن ٹائم آؤٹ: اگر کوئی ایکسپریشن چلنے میں بہت زیادہ وقت لے تو یہ پیغام ظاہر ہوتا ہے:
"اس XPath کو چلنے میں بہت زیادہ وقت لگا۔ ایکسپریشن کو محدود کریں یا چھوٹا نمونہ استعمال کریں۔"
- غیر درست ایکسپریشن: اگر آپ کا لکھا گیا پاتھ سنٹیکس کے لحاظ سے درست نہ ہو تو یہ پیغام ملتا ہے:
"یہ XPath ایکسپریشن درست نہیں ہے۔"
- ایویلیوایشن کی ناکامی: اگر ایکسپریشن درست ہو لیکن اس کا اندازہ لگانا ممکن نہ ہو تو ٹول یہ ظاہر کرتا ہے:
"اس XPath کا اندازہ نہیں لگایا جا سکا۔"
نتائج کا معائنہ اور آؤٹ پٹ فارمیٹ
جب آپ ٹیسٹ چلاتے ہیں تو ٹول درج ذیل معلومات فراہم کرتا ہے:
- حروف کی تعداد: ان پٹ دستاویز میں موجود کل حروف کی تعداد۔
- نتائج کی تعداد: مطابقت رکھنے والے کل نوڈس کی تعداد۔
- تفصیل: ہر مطابقت رکھنے والے نوڈ کے لیے اس کی قسم، نام، پاتھ اور ویلیو کا پریویو۔
- نتیجہ کاپی کریں: ہر انفرادی نتیجے کے ساتھ ایک بٹن ہوتا ہے جس پر کلک کر کے اس کی ویلیو کاپی کی جا سکتی ہے۔
اگر دستاویز میں کوئی بھی مماثلت نہ ملے تو ٹول یہ پیغام دکھاتا ہے:
"کوئی نتیجہ نہیں ملا۔"
جب مطابقت رکھنے والے نتائج کی تعداد 200 سے زیادہ ہو جائے تو ٹول صرف پہلے 200 نتائج دکھاتا ہے اور یہ نوٹ ظاہر کرتا ہے:
"پہلے
{max}دکھائے جا رہے ہیں۔"
لائیو ویب صفحات کے مقابلے میں حدود
یہ ٹول ایک کلائنٹ سائیڈ ٹیسٹر ہے۔ یہ کسی لائیو ویب پیج کے حقیقی وقت کے ڈھانچے (real-time structure)، رینڈر شدہ DOM، یا نیٹ ورک ریکویسٹس کی نمائندگی نہیں کرتا۔ یہ صرف آپ کے فراہم کردہ جامد (static) XML یا HTML ٹیکسٹ پر ہی ایکسپریشنز کا جائزہ لیتا ہے۔
اکثر پوچھے گئے سوالات (FAQ)
کیا میں XML کے ساتھ ساتھ HTML پر بھی XPath کا ٹیسٹ کر سکتا ہوں؟
جی ہاں۔ XML موڈ XML نیم اسپیس کے قوانین کو برقرار رکھتا ہے۔ HTML موڈ لچکدار ہے اور //a جیسے سادہ پاتھ کو عام ٹیگز سے میچ کرنے دیتا ہے۔
XML نیم اسپیسز کیسے کام کرتی ہیں؟
آپ کے XML میں ڈیکلیئر کردہ نیم اسپیس پریفکسز کو XPath میں استعمال کیا جا سکتا ہے، جیسے //x:item۔ ڈیفالٹ نیم اسپیسز کے لیے، //item بھی دستاویز کے ڈیکلیئریشن کی پیروی کرتا ہے۔
کوئی سوال ٹائم آؤٹ کیوں ہو سکتا ہے؟
بہت بڑی دستاویزات یا وسیع ایکسپریشنز کا اندازہ لگانا مہنگا ہو سکتا ہے۔ یہ ٹول 2 سیکنڈ کے بعد رن کو روک دیتا ہے تاکہ صفحہ فعال رہے؛ پاتھ کو محدود کریں یا چھوٹا نمونہ آزمائیں۔
کیا میرا ڈیٹا محفوظ رہتا ہے؟
آپ کے XML، HTML اور XPath کا ٹیسٹ آپ کے براؤزر میں کیا جاتا ہے۔ BroBroGo پر کچھ بھی اپ لوڈ نہیں کیا جاتا۔