CKTIS / JavaScript
URIError — грешка при кодиране или декодиране на URI
URIError е вграден тип грешка в JavaScript, който сигнализира за неправилни данни при кодиране или декодиране на URI. Научете за обичайните причини, създаването на грешката и избирателната обработка на изключения.
Версия: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Синтаксис
new URIError(message)
URIError(message)URIError е стандартен тип грешка в ECMAScript, който наследява Error; той не е интерфейс на Web API. Не обозначава произволен невалиден адрес, а грешки при операциите за кодиране и декодиране на URI.
decodeURI и decodeURIComponent хвърлят URIError, когато срещнат неправилни процентни escape последователности, например %ZZ, или байтови последователности, които не кодират валиден UTF-8. encodeURI и encodeURIComponent го хвърлят при несдвоен UTF-16 сурогат. Вариантите с Component обработват отделни компоненти на URI; останалите отчитат ролята на запазените знаци в цял URI.
new URIError(message) създава обект; самото му създаване не хвърля изключение. Извикването URIError(message) без new също създава обект. За да хвърлите собствена грешка, използвайте throw new URIError(message). Свойството name има стойност по подразбиране "URIError"; автоматично генерираният текст на message зависи от реализацията.
Поставете декодирането на недоверени данни в блок try...catch. В обичаен код, изпълняван в рамките на един realm, проверете error instanceof URIError и хвърлете отново останалите изключения. Тази проверка може да не успее за грешка от друг realm, например от друг frame. Примерът декодира валиден текст и обработва непълна UTF-8 последователност, без да разчита на текста на съобщението.
Примери
for (const input of ["hello%20world", "%E0%A4"]) {
try {
console.log(decodeURIComponent(input));
} catch (error) {
if (!(error instanceof URIError)) throw error;
console.log(error.name);
}
}Резултат
hello world URIError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.