querystring

Wandelt ein Objekt in eine URL-Abfragezeichenkette um.

API

querystring

Rückgabe

Argument	Beschreibung	Typ
`string`	Die Abfragezeichenkette	`string`

Parameter

Parameter	Beschreibung	Typ	Standard
`data`	Umzuwandelndes Objekt	`Object`	`{}`

Beispiel

Grundlegende Verwendung

import { querystring } from 'ranuts';

const params = {
  name: 'John',
  age: 30,
  city: 'New York',
};

const query = querystring(params);
console.log(query); // 'name=John&age=30&city=New%20York'

Eine URL zusammensetzen

import { querystring } from 'ranuts';

const baseUrl = 'https://api.example.com/users';
const params = {
  page: 1,
  limit: 10,
  sort: 'name',
};

const url = `${baseUrl}?${querystring(params)}`;
console.log(url);
// 'https://api.example.com/users?page=1&limit=10&sort=name'

Sonderzeichen

import { querystring } from 'ranuts';

const params = {
  search: 'hello world',
  category: 'web development',
};

const query = querystring(params);
console.log(query); // 'search=hello%20world&category=web%20development'

undefined und null fallen weg

import { querystring } from 'ranuts';

const params = {
  name: 'John',
  age: undefined,
  city: null,
  active: true,
};

const query = querystring(params);
console.log(query); // 'name=John&active=true'
// Werte, die undefined oder null sind, fallen weg

Hinweise

URL-Kodierung: Die Werte werden von allein URL-kodiert.
Leere Werte: undefined und null werden aussortiert und tauchen in der Zeichenkette nicht auf.
Muss ein Objekt sein: Wird etwas anderes übergeben, fliegt ein TypeError.
Vorverarbeitung: Schlüssel wie Werte laufen vor dem Kodieren durch decodeURIComponent.