This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

FormData.getAll()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨октябрь 2018 г.⁩.

Примечание: Эта возможность доступна в Web Workers.

getAll() - метод объекта FormData, который возвращает все значения, связанные с ключом в объекте FormData.

Синтаксис

js
formData.getAll(name);

Параметры

name

Строка формата USVString, задающая имя ключа.

Возвращает

Массив значений типа FormDataEntryValue, привязанных к ключу, переданному в параметре name. Если переданный ключ не существует, метод вернёт пустой массив.

Пример

Эта строка создаст пустой объект FormData:

js
var formData = new FormData();

Можем добавить два username при помощи FormData.append:

js
formData.append("username", "Борис");
formData.append("username", "Кирилл");

Тогда метод getAll() вернёт оба значения username в виде массива:

js
formData.getAll("username"); // Вернёт ["Борис", "Кирилл"]

Спецификации

Specification
XMLHttpRequest
# dom-formdata-getall

Совместимость с браузерами

Смотрите также