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 پارامتر

رشتهٔ Query خام:

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

پارامترهای کوئری

کلید:param1

مقدار:value1

کپی به‌صورت جفت کلید=مقدار

کلید:param2

مقدار:value%202(رمزگشایی‌شده: value 2)

کپی به‌صورت جفت کلید=مقدار

کلید:param3

مقدار:test

کپی به‌صورت جفت کلید=مقدار

ورودی رشتهٔ کوئری

Loading editor...

جزئیات فنی

نحوهٔ کارِ تجزیه‌کنندهٔ Query String

این ابزار چه کاری انجام می‌دهد

تجزیه‌کنندهٔ Query String پارامترهای جداگانه را از رشته‌های Query در URL استخراج و دیکد می‌کند و بررسی، دیباگ و درک جفت‌های کلید-مقدارِ ارسال‌شده در URLها را آسان می‌سازد. این تجزیه‌کنندهٔ آنلاین Query String هم مقادیر کدگذاری‌شده و هم دیکدشدهٔ پارامترها را مدیریت می‌کند و قالب خامِ کدگذاری‌شده را در کنار مقادیر دیکدشده و قابل‌خواندن نمایش می‌دهد. وقتی نیاز دارید Query Stringهایی مانند "?param1=value1&param2=value%202" را تجزیه کنید، این ابزار هر پارامتر را تفکیک می‌کند، نسخهٔ کدگذاری‌شده و دیکدشده را نشان می‌دهد و کمک می‌کند بفهمید کدگذاری URL چگونه روی دادهٔ شما اثر می‌گذارد. دیکدر Query String به‌ویژه هنگام دیباگ کردن فراخوانی‌های API، تحلیل درخواست‌های وب یا درک نحوهٔ انتقال داده از طریق URLها در برنامه‌های وب مفید است. برخلاف تجزیه‌کننده‌های کامل URL، این ابزار مشخصاً روی بخش Query String تمرکز دارد؛ بنابراین زمانی ایده‌آل است که فقط پارامترهای Query را دارید و نه کل URL.

موارد استفادهٔ رایج برای توسعه‌دهندگان

توسعه‌دهندگان هنگام دیباگ کردن endpointهای API، تحلیل درخواست‌های وب یا درک جریان داده از طریق پارامترهای URL از تجزیه‌کننده‌های Query String استفاده می‌کنند. تجزیه‌کنندهٔ Query String هنگام کار با REST APIها، رسیدگی به ارسال فرم‌ها از طریق درخواست‌های GET یا پیاده‌سازی قابلیت جست‌وجویی که فیلترها را از طریق پارامترهای Query منتقل می‌کند ضروری است. بسیاری از توسعه‌دهندگان هنگام دیباگ ارتباط کلاینت-سرور، اطمینان از درست کار کردن کدگذاری URL یا استخراج پارامترهای مشخص از Query Stringهای پیچیده نیاز به دیکد کردن Query String دارند. این ابزار هنگام پیاده‌سازی مسیریابی URL، تجزیهٔ پارامترهای Query در کد سمت سرور یا درک اینکه فریم‌ورک‌ها چگونه کدگذاری و دیکد پارامترهای URL را انجام می‌دهند کمک می‌کند. توسعه‌دهندگان فرانت‌اند از این ابزار برای اطمینان از ساخت Query String، تست کدگذاری پارامترها یا دیباگ مشکلات مدیریت وضعیت مبتنی بر URL استفاده می‌کنند. دیکدر Query String هنگام کار با ابزارهای تحلیل‌گر، پارامترهای رهگیری یا پیاده‌سازی URLهای قابل‌اشتراک‌گذاری با وضعیتِ جاسازی‌شده ارزشمند است.

قالب‌ها، نوع‌ها یا گونه‌های داده

Query Stringها از قالب استاندارد کدگذاری URL پیروی می‌کنند: جفت‌های key=value که با امپرسند (&) از هم جدا می‌شوند و ممکن است با علامت سؤال (?) در ابتدای آن‌ها همراه باشند. نام و مقدار پارامترها معمولاً با کدگذاری درصدی (percent encoding) در URL کدگذاری می‌شوند (مثلاً فاصله‌ها به %20 تبدیل می‌شوند و @ به %40). این تجزیه‌کننده هم مقادیر کدگذاری‌شده و هم کدگذاری‌نشده را مدیریت می‌کند و قالب خام و قالب دیکدشده را کنار هم نشان می‌دهد. Query Stringها می‌توانند نام پارامتر تکراری داشته باشند (هرچند بیشتر تجزیه‌کننده‌ها فقط آخرین مقدار را نگه می‌دارند)، مقدارهای خالی (key=&key2=value) و کاراکترهای ویژه‌ای که نیاز به کدگذاری دارند. برخی Query Stringها از نشانه‌گذاری آرایه (key[]=value1&key[]=value2) یا نشانه‌گذاری آبجکت (key[subkey]=value) استفاده می‌کنند که به منطق تجزیهٔ ویژه نیاز دارد. این ابزار معمولاً پارامترها را در قالبی ساخت‌یافته نمایش می‌دهد و برای هر جفت پارامتر، کلیدِ کدگذاری‌شده، کلیدِ دیکدشده، مقدارِ کدگذاری‌شده و مقدارِ دیکدشده را نشان می‌دهد.

دام‌های رایج و حالت‌های لبه‌ای

هنگام تجزیهٔ Query Stringها، به یاد داشته باشید کدگذاری URL می‌تواند پیچیده باشد: برخی کاراکترها مثل فاصله می‌توانند به‌صورت %20 یا + کدگذاری شوند و تجزیه‌کننده باید هر دو قالب را درست مدیریت کند. نام‌های پارامتر تکراری در Query Stringها رایج‌اند، اما بیشتر تجزیه‌کننده‌ها (از جمله URLSearchParams) فقط آخرین مقدار را نگه می‌دارند، بنابراین ممکن است مقادیر قبلی را از دست بدهید. مقادیر خالی پارامترها (key=) معتبر هستند و باید به‌عنوان رشتهٔ خالی مدیریت شوند، نه به‌عنوان پارامترِ موجود‌نبودن. کاراکترهای ویژه در نام یا مقدار پارامترها باید درست کدگذاری شوند، اما برخی کاراکترها مانند حروف و اعداد و بعضی نمادها نیازی به کدگذاری ندارند. تجزیه‌کنندهٔ Query String باید ورودی بدشکل را به‌صورت مناسب مدیریت کند، مانند امپرسندهای کدگذاری‌نشده در مقدارها یا جفت‌های کلید-مقدار ناقص. توجه داشته باشید سیستم‌های مختلف ممکن است تجزیهٔ Query String را کمی متفاوت انجام دهند، به‌خصوص دربارهٔ کلیدهای تکراری، نشانه‌گذاری آرایه یا نشانه‌گذاری آبجکت تو‌در‌تو. همیشه تجزیهٔ Query String خود را با نمونه‌های واقعی که شامل کاراکترهای ویژه، کاراکترهای یونیکد و حالت‌های لبه هستند تست کنید.

چه زمانی از این ابزار استفاده کنیم در برابر کُد

از تجزیه‌کننده‌های Query String مبتنی بر مرورگر برای دیباگ سریع، تست کدگذاری پارامترها یا زمانی که لازم است در طول توسعه Query Stringها را دستی بررسی کنید استفاده کنید. این ابزارها برای درک اینکه Query Stringها چگونه ساخته می‌شوند، اطمینان از رفتار کدگذاری URL یا استخراج پارامترها از URLهایی که از نوار آدرس مرورگر کپی شده‌اند ایده‌آل‌اند. برای برنامه‌های تولیدی، از API بومی URLSearchParams در جاوااسکریپت، urllib.parse در پایتون یا کتابخانه‌های تجزیهٔ داخلی مشابه در زبان برنامه‌نویسی خود استفاده کنید. راهکارهای مبتنی بر کد امکان دست‌کاری برنامه‌پذیر Query String، یکپارچگی با سیستم‌های مسیریابی و استخراج خودکار پارامترها را فراهم می‌کنند. ابزارهای مرورگر در دیباگ تعاملی و آموزش عالی هستند، در حالی که راهکارهای مبتنی بر کد رسیدگی سیستماتیک و تکرارپذیر به Query String را به‌عنوان بخشی از منطق برنامهٔ شما ارائه می‌دهند. استفاده از هر دو رویکرد را در نظر بگیرید: ابزارهای مرورگر برای توسعه و دیباگ، و راهکارهای مبتنی بر کد برای قابلیت‌های تولیدی.