Solved: read url parameters


In the contemporary digital landscape, URL parameters are crucial as they allow for tracking source information in reference to analytics. Additionally, they enable developers to personalize experiences per each user. Essentially, URL parameters are a way to save states in a stateless environment like the web. Working with URL parameters in TypeScript, a strongly typed superset of JavaScript, gives developers the opportunity to work safe and sound knowing that all types are checked during compile-time.

Reading URL Parameters in TypeScript

Utilizing TypeScript, one can parse URL parameters in a fairly simple and direct way. The fundamental building block in achieving this task is using an interface to define how our expected URL parameters will look like.

interface UrlParameters {
  parameter1?: string;
  parameter2?: number;
  parameter3?: string;

URLSearchParams, a built-in browser API, comes in handy when reading URL parameters. Let’s explore this further.

Solution: URL Search Params to the Rescue

With URLSearchParams, we can read the parameters from the URL. We simply create a new instance of this class by passing the query-string part of the URL to its constructor.

const urlParameters: UrlParameters = {};
const params = new URLSearchParams(;
for (let param of params) {
  urlParameters[param[0]] = param[1];

In the above code, a new URLSearchParams object is created using the current page’s URL parameters. These parameters are then looped through and added into our UrlParameters object. The great thing is, URLSearchParams works seamlessly with TypeScript’s strong typing features.

Step-by-Step Explanation of Code

In the first step, we define an interface for URL parameters. The question mark after the keys signifies that these parameters are optional.

  • Then, we proceed to create a new instance of URLSearchParams, passing the URL parameters (obtained from to the constructor. This will automate the process of parsing the parameters.
  • Following this, a for..of loop is initiated over the URLSearchParams object. Each parameter and its value is placed into our UrlParameters object.

This way, we can use the parameters throughout our code in an organized and type-safe manner.

Additional Libraries to Handle URL Parameters

Although JavaScript and by extension TypeScript provide built-in methods to handle URL parameters, there are libraries such as query-string or js-url that provide more extensive parsing options. These libraries offer methods to stringify, parse, extract, or manipulate url parameters more comprehensively.

Harnessing URL parameters with TypeScript’s type safety allows for more secure, scalable, and maintainable code. This method translates to a more seamless user experience, highly customizable to each session. It’s one among the many developer “superpowers” TypeScript grants you in your web development journey.

Related posts:

Leave a Comment