What are the components of a URL?

A full URL has these components: scheme (https://), authority (user:password@host:port), path (/path/to/page), query (?key=value&key2=value2), and fragment (#section). Example: https://user:pass@example.com:8080/api/v1/users?sort=name&page=2#results. The scheme and host are required; all others are optional. In browsers, the fragment (#) is never sent to the server — it is processed client-side only.

What is the difference between a URL, URI, and URN?

A URI (Uniform Resource Identifier) is the broadest term — any string that identifies a resource. A URL (Uniform Resource Locator) is a URI that includes the location/protocol to retrieve the resource (https://, ftp://, mailto:). A URN (Uniform Resource Name) identifies a resource by name without location, e.g. urn:isbn:0451450523. In practice, 'URL' is used colloquially to mean any web address, and the distinction between URL and URI rarely matters for web development.

What is the difference between URL encoding and URL parsing?

URL parsing splits a URL into its structural components (scheme, host, path, query, fragment). URL encoding (percent-encoding) converts special characters in URL components to %XX format — e.g. spaces become %20, & becomes %26 when it appears in a value rather than as a parameter separator. They work together: parse first to identify components, then decode each component's percent-encoding to get the actual values. In JavaScript, use new URL(str) to parse and URLSearchParams to decode query parameters.

How do I parse a URL in JavaScript?

Use the built-in URL API: const url = new URL('https://example.com/path?key=value#hash'). Properties: url.protocol ('https:'), url.hostname ('example.com'), url.port (''), url.pathname ('/path'), url.search ('?key=value'), url.hash ('#hash'), url.searchParams.get('key') ('value'). The URL constructor throws for invalid URLs. For relative URLs, provide a base: new URL('/path', 'https://example.com'). Available in all modern browsers and Node.js 10+.

تجزیه‌گر URL

نمونه URLها

URL تجزیه‌شده

URL معتبر

نشانی اینترنتی کامل:

https://example.com/path/to/page?param1=value1&param2=value%202#section

اجزای URL

پروتکل:

https

نام میزبان:example.com

مسیر:/path/to/page

هش:#section

مبدأ:https://example.com

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

کلید:param1

مقدار:value1

کلید:param2

مقدار:value 2

ورودی URL

Loading editor...

جزئیات فنی

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

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

تجزیه‌گر URL، آدرس‌ها را به بخش‌های تشکیل‌دهنده‌شان تقسیم می‌کند و درک و اشکال‌زدایی ساختار URL را آسان می‌سازد. این ابزار URLها را تجزیه می‌کند و پروتکل، نام میزبان، پورت، مسیر، پارامترهای کوئری، هش و سایر مؤلفه‌ها را در قالبی منظم نمایش می‌دهد. وقتی نیاز دارید URL را به‌صورت آنلاین تجزیه کنید، این ابزار از API بومی URL مرورگر برای استخراج دقیق همهٔ اجزای URL استفاده می‌کند. ابزار همچنین پارامترهای کوئریِ URL-encoded را رمزگشایی می‌کند و هم مقدارهای رمزگذاری‌شده و هم رمزگشایی‌شده را نشان می‌دهد. این کار اشکال‌زدایی URLها، درک ساختار رشتهٔ کوئری و بررسی قالب‌بندی URL را ساده می‌کند. تجزیه‌گر URL به توسعه‌دهندگان کمک می‌کند مشکلات ساخت URL را سریع شناسایی کنند، مؤلفه‌های URL را اعتبارسنجی کنند و URLهای پیچیده با چندین پارامتر کوئری را بهتر بفهمند.

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

توسعه‌دهندگان هنگام اشکال‌زدایی endpointهای API، تحلیل درخواست‌های وب یا درک ساختار URLها در لاگ‌ها از تجزیه‌گر URL استفاده می‌کنند. این ابزار برای استخراج پارامترهای کوئری از URLها، بررسی URL encoding یا کنترل درست‌بودن قالب URLها ارزشمند است. بسیاری از توسعه‌دهندگان هنگام کار با REST APIها، ریدایرکت‌های OAuth یا وبهوک‌هایی که داده را از طریق پارامترهای URL منتقل می‌کنند از تجزیه‌گر URL استفاده می‌کنند. این ابزار در عیب‌یابی باگ‌های مرتبط با URL، اعتبارسنجی ساخت URL در کد یا درک URLهای پیچیده با چندین پارامتر کوئری کمک می‌کند. تجزیه‌گرهای URL همچنین هنگام تحلیل ترافیک وب، اشکال‌زدایی مشکلات مسیریابی یا استخراج مؤلفه‌های خاص از URLها برای پردازش مفید هستند. هنگام کار با رشته‌های کوئری URL، این ابزار دیدن همهٔ پارامترها را در یک نگاه آسان می‌کند، از جمله مقدارهای رمزگذاری‌شده و رمزگشایی‌شدهٔ آن‌ها.

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

این تجزیه‌گر URL از قالب‌های استاندارد URL شامل HTTP، HTTPS و سایر پروتکل‌ها پشتیبانی می‌کند. URLهای دارای پروتکل یا بدون پروتکل را مدیریت می‌کند (در صورت نبود، به‌طور خودکار https:// را اضافه می‌کند)، URLهای دارای اطلاعات احراز هویت (username:password@host)، URLهای دارای پورت، رشته‌های کوئری و قطعه‌های هش. ابزار پارامترهای کوئری را تجزیه می‌کند و آن‌ها را در قالب جدول نمایش می‌دهد و هم مقدارهای خامِ رمزگذاری‌شده و هم مقدارهای رمزگشایی‌شده را نشان می‌دهد. برای مثال، یک URL مانند:

https://example.com/path?name=John%20Doe&age=30&city=New%20York#section

تجزیه می‌شود تا پروتکل (https)، نام میزبان (example.com)، مسیر (/path)، پارامترهای کوئری (name=John Doe, age=30, city=New York) و هش (#section) را نشان دهد. ابزار رمزگذاری و رمزگشایی URL را به‌صورت خودکار انجام می‌دهد و دیدن مقدارهای واقعیِ پارامترهای رمزگذاری‌شده را آسان می‌کند.

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

یکی از مشکلات رایج، URLهای بدون پروتکل است—ابزار تلاش می‌کند https:// را به‌طور خودکار اضافه کند، اما این کار همیشه درست نیست. URLهایی که در پارامترهای کوئری کاراکترهای ویژه دارند باید به‌درستی رمزگذاری شوند و ابزار برای کمک به شناسایی مشکلات رمزگذاری، هم مقدارهای رمزگذاری‌شده و هم رمزگشایی‌شده را نشان می‌دهد. URLهای دارای اطلاعات احراز هویت (username:password) باید با احتیاط مدیریت شوند زیرا گذرواژه‌ها نمایش داده می‌شوند (هرچند در رابط کاربری ماسک می‌شوند). URLهای نسبی ممکن است بدون زمینهٔ یک URL پایه به‌درستی تجزیه نشوند. URLهایی با چندین پارامتر کوئری با کلید یکسان توسط URL API مدیریت می‌شوند، اما برخی سناریوها ممکن است به رسیدگی ویژه نیاز داشته باشند. نام‌های دامنهٔ بین‌المللی (IDN) و URLهای دارای کاراکترهای غیر ASCII ممکن است به رمزگذاری ویژه نیاز داشته باشند. این ابزار از تجزیه‌گر URL بومی مرورگر استفاده می‌کند که از قواعد استاندارد تجزیهٔ URL پیروی می‌کند، اما موارد لبه‌ای مانند URLهای بدقالب یا URLهای دارای کاراکترهای غیرمعمول ممکن است مطابق انتظار تجزیه نشوند.

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

از این تجزیه‌گر URL برای اشکال‌زدایی سریع، تحلیل موردی URL یا زمانی که خارج از محیط توسعه کار می‌کنید استفاده کنید. برای تجزیهٔ URLهای موجود در لاگ‌ها، پاسخ‌های API یا تب‌های Network مرورگر ایده‌آل است. تفکیک بصری مؤلفه‌های URL باعث می‌شود URLهای پیچیده را در یک نگاه درک کنید. برای کد تولیدی، از کتابخانه‌های تجزیهٔ URL که در برنامهٔ شما یکپارچه شده‌اند استفاده کنید تا URLها را به‌عنوان بخشی از پایپ‌لاین‌های پردازش داده تجزیه کنند. کتابخانه‌های تجزیهٔ URL معمولاً مدیریت خطای دقیق‌تری ارائه می‌دهند و موارد لبه‌ای را با ظرافت بیشتری پوشش می‌دهند. ابزارهای مرورگر در تجزیه و اشکال‌زدایی موردی عالی هستند، در حالی که راهکارهای مبتنی بر کد، خودکارسازی، یکپارچگی با پایپ‌لاین‌های CI/CD و توانایی تجزیهٔ کارآمدِ دسته‌های بزرگ URL را فراهم می‌کنند.