JavaScript URLSearchParams.append() — додати ще одне значення

Метод append() додає значення параметра, не чіпаючи наявні.

правити

Загальний опис

Саме він створює повторювані ключі: ?tag=css&tag=js. Потрібен там, де значень справді може бути кілька — теги, категорії, обрані фільтри.

Якщо ж значення має бути одне (сторінка, сортування), бери set() — інакше параметри почнуть накопичуватись, і адреса поступово перетвориться на сміття.

правити

Нотатка

Найчастіша помилка — append() у пагінації. Клацнув по сторінках п'ять разів — і в адресі п'ять параметрів page, а сервер бере перший.

автор: NagarD правити

+ додати пораду чи нотатку

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
append	49+	29+	10.1+	36+	17+	-

Підтримка: мобільні переглядачі

Переглядач
append	49+	yes	yes	10.3+

Приклади

+ запропонувати свій приклад у пісочниці

const params = new URLSearchParams();

// кілька значень — append
for (const tag of ['css', 'js', 'html']) {
    params.append('tag', tag);
}

console.log(params.toString()); // 'tag=css&tag=js&tag=html'

// одне значення — set
params.set('page', '2');

// а так параметри накопичуються — це баг:
// params.append('page', '3'); → page=2&page=3