Объект FormData

  FormData - интерфейс к данным виртуальной формы.
  Отправка формы на сервер может быть выполнена не только с помощью элемента INPUT TYPE="submit", но, например, методом fetch объекта Window.
  Для таких случаев и предназначен интерфейс FormData, который позволяет создавать в памяти аналог набора данных, который мог бы быть получен с помощью элемента тега FORM в формате ENCTYPE="multipart/form-data". Каждая строка такого набора данных состоит из пары соответствия:

        имя строки - значение строки

  (аналога, например, NAME - VALUE). Имя строки является ключём набора данных, по которому любая его строка и её значение могут быть идентифицированы скриптом с помощью интерфейса FormData.
  Этот ключ не является уникальным, то есть в наборе данных формы может быть несколько строк с одинаковым именем.
  Экземпляр доступен:

  1. В выражении

    new FormData([Форма])

    где:
    • new - Ключевое слово.
    • FormData - Ключевое слово.
    • Форма - Ссылка на экземпляр объекта HTMLFormElement для формы, по шаблону которой создаётся экземпляр объекта FormData.

  2. Как результат - "обещания" чтения тела ресурса, инициированного методом formData объекта Response.

  3. Как результат - "обещания" чтения тела запроса, инициированного методом formData объекта Request.

  Методы.
  append - Добавляет новую строку с заданными именем и значением в эту форму.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.append(Имя, Значение[, Имя файла])

Значения формата записи:

  delete - Удаляет все строки с заданным именем из этой формы.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.delete(Имя)

Значения формата записи:

  entries - Возвращает интерфейс Iterator к последовательности пар имя-значение этой формы.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.entries()

Значения формата записи:

  forEach - Вызывает заданную функцию один раз для каждой строки этой формы.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.forEach(Функция[,Объект])

Значения формата записи:

  get - Возвращает значение строки с заданным именем из этой формы.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.get(Имя)

Значения формата записи:

  getAll - Возвращает массив всех значений строк с заданным именем из этой формы.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.getAll(Имя)

Значения формата записи:

  has - Возвращает значение true если строка с заданными именем имеется в этой форме, и значение false - в противном случае.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.has(Имя)

Значения формата записи:

  keys - Возвращает интерфейс Iterator к последовательности имён строк этой формы.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.keys()

Значения формата записи:

  set - Добавляет новую строку с заданными именем и значением в эту форму, или заменяет значение в имеющейся строке с таким именем.
  Возвращает значение undefined.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.set(Имя, Значение[, Имя файла])

Значения формата записи:

  values - Возвращает интерфейс Iterator к последовательности значений строк этой формы.

Формат записи в коде скрипта:

  • Экземпляр объекта FormData.values()

Значения формата записи: