← All resources
The toolkit · Resource guide

Build query parameters safely

Construct a URL query using browser encoding rather than string concatenation.

Visit website (opens in a new tab)
Understand the tool

Overview

Construct a URL query using browser encoding rather than string concatenation.

The example below is an original, minimal illustration of the referenced web-platform feature. Read the official reference and adapt it before using it in a real project.

Best for

  • Understanding build query parameters safely.
  • Trying the pattern in an isolated page.
  • Adapting the example to an existing website.

Key features

  • Encoded parameters
  • URL construction
  • Search links
A practical walkthrough

Getting started

  1. Read the example and reference. Identify the selectors, files or values that belong to your project.

  2. Try it in isolation. Use a disposable test page and adapt the example values.

  3. Verify before reuse. Check keyboard behavior, responsive layout and relevant browser support.

Things to know

  • These examples are learning material, not a drop-in application.
  • Replace example filenames, selectors and routes as needed.
  • Test changes on staging and escape data for the context where it is used.

Code example

Original illustrative example. Adapt filenames and selectors, and test on staging before reuse.

const url = new URL('/useful-link/', location.origin);
url.search = new URLSearchParams({ resource_search: 'color & contrast', resource_topic: 'accessibility' });
console.log(url.href);

Useful alongside this

Accessibility

Text

Visual

Orientation

Accessibility settings