What is a query string and how does it work?

A query string is the part of a URL after the ? that contains key-value pairs separated by &. Example: ?name=John&age=30&city=New%20York. Keys and values are percent-encoded: spaces become %20 or +, & in values becomes %26. The server receives the raw query string and parses it into parameters. In JavaScript, new URL(window.location.href).searchParams provides easy access without manual parsing.

How do I parse a query string in JavaScript?

Use URLSearchParams: const params = new URLSearchParams('?name=John&age=30'); params.get('name') // 'John'. For browser URLs: const params = new URL(window.location.href).searchParams. To iterate: for (const [key, value] of params) {...}. To get all values for a repeated key (arrays): params.getAll('tag'). To build a query string: new URLSearchParams({name:'John', age:30}).toString() → 'name=John&age=30'. Available in all modern browsers and Node.js 10+.

How are arrays represented in query strings?

There is no standard for arrays in query strings — different frameworks use different conventions. Common formats: repeated keys: ?tag=js&tag=css (parsed by URLSearchParams.getAll()); bracket notation: ?tags[]=js&tags[]=css (PHP style, Rails); dot notation: ?tags.0=js&tags.1=css; JSON-encoded: ?tags=["js","css"]. URLSearchParams handles repeated keys; for bracket notation you need qs library (Node.js) or similar. When designing APIs, repeated keys are the most universally supported.

What is the maximum length of a URL and query string?

HTTP/1.1 has no specified URL length limit, but servers and browsers impose practical limits. Chrome and Firefox support URLs up to ~2MB. IE limited URLs to 2,048 characters (this became the informal web standard). Apache and Nginx default to 8KB and 4KB for request URI respectively. AWS API Gateway limits query strings to 10KB. As a practical rule: keep URLs under 2,000 characters for broad compatibility. For large data, use POST with a request body instead of GET with a long query string.

محلل سلسلة الاستعلام

سلاسل استعلام نموذجية

سلسلة الاستعلام المُحلَّلة

سلسلة استعلام صالحة

3 معلمات

سلسلة الاستعلام الخام:

param1=value1&param2=value%202&param3=test

معلمات الاستعلام

المفتاح:param1

القيمة:value1

نسخ كزوج key=value

المفتاح:param2

القيمة:value%202(مفكوك الترميز: value 2)

نسخ كزوج key=value

المفتاح:param3

القيمة:test

نسخ كزوج key=value

إدخال سلسلة الاستعلام

Loading editor...

التفاصيل التقنية

كيف يعمل محلّل سلسلة الاستعلام

ما الذي تفعله الأداة

يستخرج محلّل سلسلة الاستعلام ويفك ترميز المعلمات الفردية من سلاسل استعلام عناوين URL، مما يجعل من السهل فحص أزواج المفتاح-القيمة الممررة في عناوين URL وتصحيحها وفهمها. يتعامل محلّل سلسلة الاستعلام عبر الإنترنت هذا مع قيم المعلمات المرمّزة وغير المرمّزة، ويعرض لك التنسيق الخام المرمّز إلى جانب القيم المفهومة بعد فك الترميز. عندما تحتاج إلى تحليل سلاسل استعلام مثل "?param1=value1&param2=value%202"، تقوم هذه الأداة بتفكيك كل معلمة، وتعرض النسختين المرمّزة والمفكوكة، وتساعدك على فهم كيف يؤثر ترميز URL على بياناتك. يُعد مفكك ترميز سلسلة الاستعلام مفيدًا بشكل خاص عند تصحيح استدعاءات API، أو تحليل طلبات الويب، أو فهم كيفية تمرير البيانات عبر عناوين URL في تطبيقات الويب. وعلى عكس محلّلات URL الكاملة، تركز هذه الأداة تحديدًا على جزء سلسلة الاستعلام، مما يجعلها مثالية عندما تكون لديك معلمات الاستعلام فقط دون سياق عنوان URL الكامل.

حالات استخدام شائعة للمطورين

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

تنسيقات البيانات أو أنواعها أو متغيراتها

تتبع سلاسل الاستعلام تنسيق ترميز URL القياسي: أزواج key=value مفصولة بعلامات العطف (&)، مع علامة استفهام اختيارية في البداية (?). عادةً ما تُرمَّز أسماء المعلمات وقيمها باستخدام ترميز النسبة المئوية (مثلًا، تتحول المسافات إلى %20، و@ إلى %40). يتعامل المحلّل مع القيم المرمّزة وغير المرمّزة، ويعرض لك التنسيق الخام والتنسيق بعد فك الترميز جنبًا إلى جنب. يمكن أن تحتوي سلاسل الاستعلام على أسماء معلمات مكررة (مع أن معظم المحلّلات تحتفظ بالقيمة الأخيرة فقط)، وقيم فارغة (key=&key2=value)، وأحرف خاصة تتطلب ترميزًا. تستخدم بعض سلاسل الاستعلام ترميز المصفوفات (key[]=value1&key[]=value2) أو ترميز الكائنات (key[subkey]=value)، ما يتطلب منطق تحليل خاص. عادةً ما تعرض الأداة المعلمات بتنسيق منظّم، موضحة المفتاح المرمّز، والمفتاح بعد فك الترميز، والقيمة المرمّزة، والقيمة بعد فك الترميز لكل زوج من المعلمات.

المزالق الشائعة والحالات الطرفية

عند تحليل سلاسل الاستعلام، تذكّر أن ترميز URL قد يكون معقدًا: فبعض الأحرف مثل المسافات يمكن ترميزها إما %20 أو +، ويجب على المحلّل التعامل مع كلا التنسيقين بشكل صحيح. أسماء المعلمات المكررة شائعة في سلاسل الاستعلام، لكن معظم المحلّلات (بما في ذلك URLSearchParams) تحتفظ بالقيمة الأخيرة فقط، لذا قد تفقد القيم السابقة. قيم المعلمات الفارغة (key=) صالحة ويجب التعامل معها كسلاسل فارغة، لا كمعلمات مفقودة. يجب ترميز الأحرف الخاصة في أسماء المعلمات أو قيمها بشكل صحيح، لكن بعض الأحرف مثل الحروف والأرقام وبعض الرموز لا تحتاج إلى ترميز. ينبغي لمحلّل سلسلة الاستعلام التعامل بسلاسة مع الإدخال غير الصحيح، مثل علامات العطف غير المرمّزة داخل القيم أو أزواج key-value غير المكتملة. انتبه إلى أن الأنظمة المختلفة قد تتعامل مع تحليل سلسلة الاستعلام بشكل مختلف قليلًا، خاصة فيما يتعلق بالمفاتيح المكررة، أو ترميز المصفوفات، أو ترميز الكائنات المتداخلة. اختبر دائمًا تحليل سلسلة الاستعلام بأمثلة واقعية تتضمن أحرفًا خاصة، وأحرف Unicode، وحالات حدّية.

متى تستخدم هذه الأداة بدلًا من الكود

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