База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Response.text() — прочитане на тялото като текст

Response.text() прочита цялото тяло на отговора и връща Promise с текст, декодиран като UTF-8.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

response.text() // Promise<string>

response.text() връща Promise<string>, който се изпълнява след прочитането на цялото тяло. Декодира байтовете като UTF-8 независимо от charset в Content-Type. Не парсва JSON.

Ако response.body е null, при всяко извикване Promise се изпълнява с празен низ, а bodyUsed остава false. Ако тялото е поток, четенето му задава bodyUsed на true, дори потокът да не съдържа нито един байт. Ако четенето на потока вече е започнало, потокът е отменен или е заключен, Promise се отхвърля с грешка TypeError. Ако трябва да прочетете два пъти тяло, предоставено като поток, извикайте response.clone() преди първото четене.

Методът буферира цялото тяло, затова имайте предвид използването на памет. Не проверява response.ok. Това е Web API, дефиниран от Fetch Standard, а не функция на ECMAScript.

Примери

(async () => {
  const response = new Response("Cześć!", {
    headers: { "Content-Type": "text/plain; charset=utf-8" }
  });
  console.log(await response.text());
  console.log(response.bodyUsed);
})().catch(console.error);

Резултат

Cześć!
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници