[{"data":1,"prerenderedAt":206},["ShallowReactive",2],{"journal-all":3,"journal-post-kesh-ne-dolzhen-lomat-zagruzku-sprajta":202},[4,14,23,32,41,50,59,68,77,86,95,104,113,122,131,140,149,158,167,175,184,193],{"id":5,"documentId":6,"title":7,"slug":8,"author":9,"displayDate":10,"publishedAt":11,"tags":12,"excerpt":13},128,"ejmfhc9x77pq7i6lk8uri7vz","Хорошие платформеры прощают маленькие ошибки","horoshie-platformery-proshhayut-malenkie-oshibki-igroka","Maxim","2026-10-08","2026-10-12T14:22:54.799Z",[],"Игрок нажал кнопку прыжка у самого края платформы, а персонаж вместо прыжка падает вниз. Или нажал прыжок чуть раньше приземления, и прыжок не…",{"id":15,"documentId":16,"title":17,"slug":18,"author":9,"displayDate":19,"publishedAt":20,"tags":21,"excerpt":22},151,"cpt6fex3mcb2pk2rwxrqlvl0","Что может локальный coding-agent на 16 GB VRAM","chto-mozhet-lokalnyj-coding-agent-na-16-gb-vram-1","2026-10-03","2026-10-22T07:06:46.248Z",[],"Обычно в работе с кодом я использую frontier-модели. Для разработки у меня достаточно мощный ПК, но специально под запуск локальных моделей я его не…",{"id":24,"documentId":25,"title":26,"slug":27,"author":9,"displayDate":28,"publishedAt":29,"tags":30,"excerpt":31},132,"pg9d6k0p2ggrjlpwnp0vmfhu","Публичный контракт вместо внутренних формул в typographics 5","publichnyj-kontrakt-vmesto-vnutrennih-formul-v-typographics-5","2026-09-03","2026-10-20T09:34:40.187Z",[],"Выпустил typographics@5.0.0. Изменение в самом CSS небольшое: блоки кода теперь по умолчанию используют ту же плавную базу, что и основной текст…",{"id":33,"documentId":34,"title":35,"slug":36,"author":9,"displayDate":37,"publishedAt":38,"tags":39,"excerpt":40},154,"bfbbuk4w3a8878alj8u8tjk7","Получить готовое решение и иметь основания ему доверять — разные вещи","poluchit-gotovoe-reshenie-i-imet-osnovaniya-emu-doveryat-raznye-veshhi","2026-08-22","2026-11-07T12:53:47.007Z",[],"Допустим, нужен поиск по каталогу. Поле ввода, запрос к серверу, список результатов. Поручаем это нейросети, получаем компонент, запускаем. Вводим…",{"id":42,"documentId":43,"title":44,"slug":45,"author":9,"displayDate":46,"publishedAt":47,"tags":48,"excerpt":49},133,"rrs7fbiul9xgn1lqvzvfkv40","Кэш не должен ломать загрузку спрайта","kesh-ne-dolzhen-lomat-zagruzku-sprajta","2026-08-11","2026-10-20T09:35:09.405Z",[],"В iconly 5.0.0 почти не добавил новых возможностей. Разобрал поведение библиотеки в нескольких ситуациях: хранилище недоступно, в кэше лежит плохой…",{"id":51,"documentId":52,"title":53,"slug":54,"author":9,"displayDate":55,"publishedAt":56,"tags":57,"excerpt":58},134,"v415k9na7rfuvuwadzaux2fq","playbackRate не вывозит","playback-rate-ne-vyvozit","2026-08-08","2026-10-20T09:35:39.760Z",[],"В mode=\"scroll\" лента должна ускоряться вместе со страницей и сохранять инерцию, когда прокрутка уже остановилась. После перехода на Web Animations…",{"id":60,"documentId":61,"title":62,"slug":63,"author":9,"displayDate":64,"publishedAt":65,"tags":66,"excerpt":67},131,"ashjhdkt56ram23r40w9vx7e","Два пути к SVG-спрайту в Iconly","dva-puti-k-svg-sprajtu-v-iconly","2026-07-11","2026-10-20T09:27:58.489Z",[],"В 3.0 у iconly появился довольно понятный контракт загрузки: при вызове init() загрузчик проверяет кэш, при необходимости получает внешний SVG-файл и…",{"id":69,"documentId":70,"title":71,"slug":72,"author":9,"displayDate":73,"publishedAt":74,"tags":75,"excerpt":76},135,"jesxp2we692xubc1lvx26tvm","Полируем clicktone","poliruem-clicktone","2026-07-03","2026-10-20T09:37:04.432Z",[],"После изменений в Web Audio поведение clicktone меня устраивает гораздо больше, чем инфраструктура вокруг пакета. Здесь есть неприятный класс ошибок…",{"id":78,"documentId":79,"title":80,"slug":81,"author":9,"displayDate":82,"publishedAt":83,"tags":84,"excerpt":85},136,"zz71n3thhwzglwwguq7j23sf","Vue поверх DOM-контроллера, а не вместо него","vue-poverh-dom-kontrollera-a-ne-vmesto-nego","2026-06-08","2026-10-20T09:37:48.997Z",[],"После 2.0.0 DOM API DialogLite позволяет передать готовый элемент или селектор, настроить закрытие, фокус и прокрутку, а затем явно уничтожить…",{"id":87,"documentId":88,"title":89,"slug":90,"author":9,"displayDate":91,"publishedAt":92,"tags":93,"excerpt":94},137,"gnxwj8ybwrbrexf3hhmg3cwj","Один AudioContext для всех звуков","odin-audio-context-dlya-vseh-zvukov","2026-06-03","2026-10-20T09:38:16.966Z",[],"В игре HopperGame звук перестал быть разовым эффектом, который можно включить и забыть. Один звук должен идти циклически, пока персонаж находится в…",{"id":96,"documentId":97,"title":98,"slug":99,"author":9,"displayDate":100,"publishedAt":101,"tags":102,"excerpt":103},149,"tb0zyd0dkyux359m1ekxjfqk","Стенограмма YouTube-видео локально на Windows через yt-dlp и Whisper от OpenAI","stenogramma-you-tube-video-lokalno-na-windows-cherez-yt-dlp-i-whisper-ot-open-ai","2026-03-17","2026-10-21T12:32:22.911Z",[],"Понадобилось получить обычный текст из YouTube-видео. Встроенная стенограмма есть не у каждого ролика, поэтому решил сделать всё локально: скачать…",{"id":105,"documentId":106,"title":107,"slug":108,"author":9,"displayDate":109,"publishedAt":110,"tags":111,"excerpt":112},138,"kcybzkzc77id357qven9oau2","Делаем API Iconly предсказуемым","delaem-api-iconly-predskazuemym","2026-01-25","2026-10-20T09:39:22.402Z",[],"В 2.0 в основном приводил в порядок внутреннее устройство iconly, сохраняя прежний способ использования. В 3.0 занялся публичным API. Я хотел, чтобы…",{"id":114,"documentId":115,"title":116,"slug":117,"author":9,"displayDate":118,"publishedAt":119,"tags":120,"excerpt":121},139,"x43svzw5tuasmmygpugo9ijk","Жёсткий DOM-контракт начал мешать","zhyostkij-dom-kontrakt-nachal-meshat","2025-12-16","2026-10-20T09:40:16.527Z",[],"В версии 1.5.1 у DialogLite был удобный, но довольно жёсткий договор с разметкой. Контроллер искал первый .dialog-lite, знал про #main-content…",{"id":123,"documentId":124,"title":125,"slug":126,"author":9,"displayDate":127,"publishedAt":128,"tags":129,"excerpt":130},140,"cvonqqvil2tn4fmgaiabss76","Две плавные шкалы вместо корня 10px","dve-plavnye-shkaly-vmesto-kornya-10px","2025-11-04","2026-10-20T09:41:13.937Z",[],"Выпустил typographics@3.0.0. Перед стабильным релизом обкатал новую мажорную версию в реальных проектах. Главное изменение оказалось не в новой…",{"id":132,"documentId":133,"title":134,"slug":135,"author":9,"displayDate":136,"publishedAt":137,"tags":138,"excerpt":139},141,"pvwfuo4kzfsvxwf7rz8tccbj","Вертикальный ритм на lh в typographics","vertikalnyj-ritm-na-lh-v-typographics","2025-09-20","2026-10-20T09:42:09.920Z",[],"Выпустил typographics@2.4.7. За последние две недели пакет заметно разросся вокруг довольно простой проблемы: на реальной странице одной шкалы…",{"id":141,"documentId":142,"title":143,"slug":144,"author":9,"displayDate":145,"publishedAt":146,"tags":147,"excerpt":148},142,"rn9rvxezqx4f3ivdrc6voh0s","Один play() для звука в мини-играх","odin-play-dlya-zvuka-v-mini-igrah","2025-04-17","2026-10-20T09:42:53.018Z",[],"В небольших промо-играх звук обычно нужен как отклик на действие пользователя, например нажатие кнопки. За таким эффектом быстро появляется…",{"id":150,"documentId":151,"title":152,"slug":153,"author":9,"displayDate":154,"publishedAt":155,"tags":156,"excerpt":157},143,"t5o8wrsruzuu542084uuz63y","Дорабатываю Iconly изнутри","dorabatyvayu-iconly-iznutri","2025-03-10","2026-10-20T09:43:35.331Z",[],"В 2.0.0 способ использования Iconly почти не изменился. Я пересмотрел внутреннюю реализацию: поиск контейнера, вставку SVG в DOM, обработку ошибок и…",{"id":159,"documentId":160,"title":161,"slug":162,"author":9,"displayDate":163,"publishedAt":164,"tags":165,"excerpt":166},144,"r0jxt6a2huml847j89tiyxrk","Расстаёмся с Custom Element","custom-element-uhodit-type-script-prihodit","2025-03-09","2026-10-20T09:44:47.700Z",[],"Custom Element давал marquee-content готовые методы жизненного цикла. Проблема появилась при интеграции с фреймворком: одним DOM-узлом одновременно…",{"id":168,"documentId":169,"title":170,"slug":171,"author":9,"displayDate":163,"publishedAt":172,"tags":173,"excerpt":174},145,"tkj2cgfjisq0rr061p90eusp","Один контроллер вместо диалогов под каждый проект","odin-kontroller-vmesto-dialogov-pod-kazhdyj-proekt","2026-10-20T09:45:24.409Z",[],"В разных проектах я снова и снова делал примерно одно и то же: находил контейнер диалога, открывал его, закрывал по кнопке или фону, переключал…",{"id":176,"documentId":177,"title":178,"slug":179,"author":9,"displayDate":180,"publishedAt":181,"tags":182,"excerpt":183},146,"ttv07xomzxiijk85sdob4rlx","SVG-спрайт в localStorage","svg-sprajt-v-local-storage","2024-06-02","2026-10-20T09:45:52.655Z",[],"Кэшировать SVG-спрайт в браузере сначала кажется задачей на несколько строк. Получил файл, положил строку в localStorage, при следующем запуске…",{"id":185,"documentId":186,"title":187,"slug":188,"author":9,"displayDate":189,"publishedAt":190,"tags":191,"excerpt":192},147,"ewuzaa0hw5kfc6gzqph0k67u","Бесконечная анимация, конечный жизненный цикл","beskonechnaya-animacziya-konechnyj-zhiznennyj-czikl","2023-10-31","2026-10-20T09:46:16.781Z",[],"Бесконечная анимация — нормальное поведение для бегущей строки. Бесконечные обработчики и наблюдатели — нет. При ручных проверках заметил, что…",{"id":194,"documentId":195,"title":196,"slug":197,"author":9,"displayDate":198,"publishedAt":199,"tags":200,"excerpt":201},148,"n9v8botqj54tx61u0jahrprs","Бегущая строка за четыре дня","begushhaya-stroka-za-chetyre-dnya","2023-03-24","2026-10-20T09:47:13.002Z",[],"Бегущая строка выглядит почти оскорбительно простой задачей — положить элементы в ряд, сдвигать их влево или вправо и повторять всё сначала. Примерно…",{"id":42,"documentId":43,"title":44,"content":203,"slug":45,"author":9,"displayDate":46,"publishedAt":47,"tags":204,"html":205},"В `iconly 5.0.0` почти не добавил новых возможностей. Разобрал поведение библиотеки в нескольких ситуациях: хранилище недоступно, в кэше лежит плохой SVG, пользовательский обработчик бросает исключение или два `init()` запускаются одновременно.\n\nСформулировал для себя правило — кэш должен помогать загрузке спрайта, но не должен быть условием успеха загрузки.\n\nВ `4.2` это правило не выполнялось. Если чтение IndexedDB или другого хранилища возвращало ошибку, `init()` завершался с `ok: false`. Ошибка записи после успешного `fetch` делала то же самое. Получалось, что необязательная оптимизация могла остановить основную операцию, хотя сеть и DOM оставались полностью рабочими.\n\nВ `5.0` изменил именно этот контракт.\n\n## У одной версии может быть несколько файлов\n\nДо этого запись кэша определялась только значением `version`:\n\n```ts\nconst cacheResult = await storage.get(resolved.version);\n```\n\nПри записи использовался тот же ключ:\n\n```ts\nawait storage.set({\n  version: resolved.version,\n  data,\n});\n```\n\nПока на странице был один файл спрайта, этого было достаточно. Но такой ключ не описывал сам ресурс. Два загрузчика с разными файлами и одинаковой версией `1.0` могли обратиться к одной и той же записи.\n\nНапример:\n\n```ts\ncreateIconly({\n  file: '\u002Fadmin-icons.svg',\n  version: '1.0',\n});\n\ncreateIconly({\n  file: '\u002Fshop-icons.svg',\n  version: '1.0',\n});\n```\n\nРаньше для хранилища это были два запроса к ключу `1.0`.\n\nВ `5.0` ключ кэша строится из URL файла и версии:\n\n```ts\nconst createCacheKey = (\n  file: string,\n  version: string,\n  baseUrl: string,\n): string => {\n  try {\n    return JSON.stringify([new URL(file, baseUrl).href, version]);\n  } catch {\n    return JSON.stringify([file, version]);\n  }\n};\n```\n\nURL сначала нормализуется относительно `ownerDocument.baseURI`. Поэтому `\u002Ficons.svg` получает абсолютную форму с учётом базового URL документа. Если `new URL()` не срабатывает, ключ строится из исходных `file` и `version`.\n\nДля встроенных хранилищ это просто новый строковый ключ. С пользовательским `IconStorage` есть важная деталь: значение теперь нужно считать непрозрачным.\n\n```ts\nexport interface IconStorage {\n  get(key: string): Promise\u003CResult\u003CIconRecord | undefined>>;\n  set(record: IconRecord): Promise\u003CResult\u003Cvoid>>;\n}\n```\n\nПоле `IconRecord.version` пока сохраняю, но при записи туда попадает уже составной ключ. То есть пользовательское хранилище не должно разбирать его как пользовательскую версию набора иконок.\n\nЭто одна из причин мажорного релиза. Ключ по-прежнему имеет тип `string`, но его смысл для пользовательского хранилища заметно изменился.\n\n## Ошибка чтения кэша больше не блокирует загрузку\n\nСледующий вопрос оказался важнее самого ключа.\n\nВ предыдущей схеме ошибка чтения останавливала `init()`:\n\n```ts\nconst cacheResult = await storage.get(resolved.version);\n\nif (!cacheResult.ok) {\n  return fail(cacheResult.error);\n}\n```\n\nНо если IndexedDB временно недоступен, зачем из-за этого отказываться от SVG, который можно получить обычным `fetch()`?\n\nТеперь ошибку чтения кэша обрабатываю отдельно:\n\n```ts\nlet cacheAvailable = true;\nlet data: string | undefined;\n\ntry {\n  const cacheResult = await storage.get(cacheKey);\n\n  if (cacheResult.ok) {\n    data = cacheResult.value?.data;\n  } else {\n    cacheAvailable = false;\n    logError(cacheResult.error);\n  }\n} catch (error: unknown) {\n  cacheAvailable = false;\n  logError(\n    createIconlyError(\n      'storage_read_failed',\n      'Failed to read from icon storage.',\n      error,\n    ),\n  );\n}\n```\n\nЗдесь я учитываю оба случая: пользовательское хранилище может вернуть `Result` с ошибкой, а может неожиданно бросить исключение или вернуть отклонённый Promise.\n\nВ обоих случаях ошибка остаётся видимой через `onError` и `logger.error`, но основной сценарий продолжается и переходит к сети.\n\nПолучается немного непривычная, но полезная ситуация:\n\n```ts\nconst errors: IconlyError[] = [];\n\nconst iconLoader = createIconly({\n  file: '\u002Ficons.svg',\n  onError: (error) => errors.push(error),\n});\n\nconst result = await iconLoader.init();\n```\n\nВ `errors` может оказаться ошибка с кодом `storage_read_failed`, а `result.ok` при этом может быть `true`, если SVG удалось скачать и вставить.\n\nЭто не означает, что ошибка кэша игнорируется. Я просто перестаю смешивать два разных результата: состояние оптимизации и результат основной операции.\n\nПосле неудачного чтения я не пытаюсь тут же делать `set()` в то же хранилище. На время текущего `init()` оно считается недоступным:\n\n```ts\nif (cacheAvailable) {\n  \u002F\u002F storage.set(...)\n}\n```\n\nЕсли чтение уже показало, что хранилище не работает как ожидается, дополнительная запись редко улучшит ситуацию.\n\n## Запись в кэш после вставки SVG\n\nТа же логика применяется к записи в кэш.\n\nВ `4.2` после `fetch` сначала выполнялся `storage.set()`. Если запись возвращала ошибку, `init()` завершался раньше вставки в DOM.\n\nТеперь последовательность другая:\n\n```text\nfetch\n  -> подготовка SVG к вставке\n  -> вставка в DOM\n  -> запись в кэш\n```\n\nСначала SVG нужно успешно вставить в DOM. Только после этого я пытаюсь сохранить исходную строку в хранилище. Ниже показана обработка `Result`, возвращённого из `storage.set()`:\n\n```ts\nconst insertResult = insertSvg(\n  containerResult.value,\n  fetchResult.value,\n  { sanitize: resolved.sanitize },\n);\n\nif (!insertResult.ok) {\n  return fail(insertResult.error);\n}\n\nif (cacheAvailable) {\n  const storeResult = await storage.set({\n    version: cacheKey,\n    data: fetchResult.value,\n  });\n\n  if (!storeResult.ok) {\n    logError(storeResult.error);\n  }\n}\n\nreturn ok(undefined);\n```\n\nНа практике это меняет две вещи.\n\nВо-первых, если `storage.set()` возвращает `Result` с ошибкой, уже успешная загрузка и вставка не превращаются в `ok: false`. Пользователь получает иконки, а проблему с кэшем можно отдельно увидеть через обработчик ошибок.\n\nВо-вторых, некорректный загруженный SVG не попадает в хранилище до проверки. Если разбор или вставка не удались, запись вообще не выполняется.\n\nМне нравится это правило больше прежнего — сохранять только то, что текущая цепочка уже смогла использовать.\n\n## Данные из кэша тоже приходится проверять\n\nИзменить момент записи в кэш оказалось недостаточно. В хранилище может лежать некорректная запись: из старой версии приложения, после ручного изменения или повреждения данных. Неожиданное содержимое может вернуть и пользовательская реализация хранилища.\n\nРаньше найденная запись кэша воспринималась как готовый результат. Если сохранённая строка не разбиралась как SVG, `insertSvg()` возвращал `parse_error`, и на этом `init()` заканчивался.\n\nТеперь загрузчик сначала пытается вставить SVG из кэша:\n\n```ts\nif (data) {\n  const insertResult = insertSvg(containerResult.value, data, {\n    sanitize: resolved.sanitize,\n  });\n\n  if (insertResult.ok) {\n    return ok(undefined);\n  }\n\n  if (insertResult.error.cause) {\n    return fail(insertResult.error);\n  }\n\n  logError(insertResult.error);\n}\n```\n\nЕсли строка не является валидным SVG-документом, ошибка логируется, а загрузчик переходит к сетевому запросу. Если свежий SVG удалось вставить, загрузчик пытается обновить запись в кэше.\n\nТак повреждённая запись кэша становится состоянием, из которого можно восстановиться, а не тупиком.\n\nПри этом я не хочу маскировать любое исключение под обычное отсутствие записи в кэше. В показанном коде ошибка вставки остаётся критической, если её `cause` приводится к `true` при проверке условия. Например, пользовательский санитайзер может бросить исключение. В таком случае молча скачать тот же SVG ещё раз — не восстановление, а сокрытие реальной проблемы в пользовательском коде.\n\nТо есть запасной путь здесь довольно узкий: испорченный документ из кэша можно заменить свежим, критическую ошибку — нет.\n\n## Исключения не должны обходить Result\n\n`Result` появился в `3.0`. Тогда же я зафиксировал, что штатные ошибки `init()` возвращаются через `Result`, а не выбрасываются наружу. Но исключения браузерных API и пользовательского кода всё ещё могли нарушить этот контракт.\n\nК `5.0` нашёл несколько таких мест.\n\nСамый простой пример — некорректный CSS-селектор:\n\n```ts\ncreateIconly({\n  container: '[',\n});\n```\n\n`document.querySelector('[')` бросает `DOMException`. Если не перехватить это исключение, оно выходит за пределы `Result`-контракта.\n\nТеперь `resolveContainer()` перехватывает исключение при поиске элемента и возвращает ошибку с кодом `container_invalid` через `Result`:\n\n```ts\ntry {\n  \u002F\u002F document.querySelector(...)\n} catch (error: unknown) {\n  return err(\n    createIconlyError(\n      'container_invalid',\n      'Failed to resolve container.',\n      error,\n    ),\n  );\n}\n```\n\nТо же самое сделано вокруг разбора SVG и вставки в DOM.\n\nОтдельный случай — пользовательские обработчики. Раньше такой код мог нарушить контракт ошибок самой библиотеки:\n\n```ts\ncreateIconly({\n  onError: () => {\n    throw new Error('reporter failed');\n  },\n});\n```\n\nТеперь исключения обработчика и `logger` перехватываются отдельно:\n\n```ts\ntry {\n  resolved.onError?.(error);\n} catch {\n  \u002F\u002F callback не должен менять Result\n}\n\ntry {\n  resolved.logger?.error?.('[Iconly error]', error);\n} catch {\n  \u002F\u002F logger тоже\n}\n```\n\nДля меня важно, чтобы ошибка в диагностическом обработчике не подменяла исходную ошибку `init()`.\n\nВесь `runInit()` дополнительно обёрнут в `try\u002Fcatch`. Для неожиданного исключения добавлен код `unexpected_error`:\n\n```ts\ntry {\n  \u002F\u002F основной init flow\n} catch (error: unknown) {\n  return fail(\n    createIconlyError(\n      'unexpected_error',\n      'Unexpected error while initializing Iconly.',\n      error,\n    ),\n  );\n}\n```\n\nАналогичная защита появилась у синхронного `createSprite().render()`.\n\nЯ не пытаюсь доказать, что JavaScript-среда в принципе больше никогда не сможет бросить исключение. Задача практичнее: ожидаемые браузерные API, пользовательское хранилище и обработчики не должны случайно обходить публичный `Result`-контракт.\n\n## Два одновременных init() — одна операция\n\nЕщё один сценарий обнаруживается, если вызвать `init()` дважды, пока первый запрос ещё выполняется.\n\nВместо двух независимых операций теперь экземпляр хранит текущий Promise:\n\n```ts\nlet inFlight: Promise\u003CResult\u003Cvoid>> | null = null;\n\nconst init = (): Promise\u003CResult\u003Cvoid>> => {\n  if (!inFlight) {\n    inFlight = runInit().finally(() => {\n      controller = null;\n      inFlight = null;\n    });\n  }\n\n  return inFlight;\n};\n```\n\nПараллельные вызовы получают один и тот же Promise:\n\n```ts\nconst first = iconLoader.init();\nconst second = iconLoader.init();\n\nconsole.log(first === second); \u002F\u002F true\n```\n\nВо время активной загрузки `abort()` отменяет общий запрос этого экземпляра, а не один из нескольких параллельных запросов.\n\nПосле завершения `inFlight` сбрасывается, и следующий `init()` снова может выполнить обычную операцию.\n\n## Открытие существующей базы IndexedDB\n\nВ адаптере поправил ещё один сценарий. Раньше база IndexedDB открывалась с фиксированной версией `1`. Это было неудобно, если база с таким `dbName` уже существовала, но пользователь выбирал другой `storeName`.\n\nТеперь адаптер сначала открывает существующую базу без принудительной версии. Если нужного хранилища объектов нет, соединение закрывается, номер версии увеличивается и хранилище создаётся через `onupgradeneeded`.\n\nКроме того, соединение закрывается на `versionchange`, а отклонённый `dbPromise` сбрасывается, чтобы следующая попытка могла снова открыть базу.\n\nЭто не меняет публичный API хранилища, но соответствует тому же принципу релиза: хранилище не должно быть хрупким только потому, что окружение оказалось чуть сложнее идеального тестового сценария.\n\n## Что теперь означает ok: true\n\nВ `5.0` внешний код по-прежнему выглядит знакомо:\n\n```ts\nconst iconLoader = createIconly({\n  file: '\u002Ficons.svg',\n  version: '1.0',\n});\n\nconst result = await iconLoader.init();\n\nif (!result.ok) {\n  console.error(result.error);\n}\n```\n\nНо смысл `result.ok` теперь точнее.\n\n`ok: true` означает, что спрайт удалось получить и вставить. Это не обещание, что попутно идеально сработал кэш. Восстановимая ошибка хранилища может быть отдельно отправлена в `onError` или `logger`, не меняя успешный результат основной операции.\n\nРаньше хранилище было вынесено в отдельную абстракцию, но ядро всё ещё относилось к нему как к обязательной части успеха. Теперь зависимость стала честнее: кэш ускоряет следующий запуск, когда доступен, и отходит в сторону, когда нет.",[],"\u003Cp class=\"body-large\">В \u003Ccode>iconly 5.0.0\u003C\u002Fcode> почти не добавил новых возможностей. Разобрал поведение библиотеки в нескольких ситуациях: хранилище недоступно, в кэше лежит плохой SVG, пользовательский обработчик бросает исключение или два \u003Ccode>init()\u003C\u002Fcode> запускаются одновременно.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Сформулировал для себя правило — кэш должен помогать загрузке спрайта, но не должен быть условием успеха загрузки.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>4.2\u003C\u002Fcode> это правило не выполнялось. Если чтение IndexedDB или другого хранилища возвращало ошибку, \u003Ccode>init()\u003C\u002Fcode> завершался с \u003Ccode>ok: false\u003C\u002Fcode>. Ошибка записи после успешного \u003Ccode>fetch\u003C\u002Fcode> делала то же самое. Получалось, что необязательная оптимизация могла остановить основную операцию, хотя сеть и DOM оставались полностью рабочими.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>5.0\u003C\u002Fcode> изменил именно этот контракт.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">У одной версии может быть несколько файлов\u003C\u002Fh2>\n\u003Cp class=\"body-large\">До этого запись кэша определялась только значением \u003Ccode>version\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> cacheResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> storage.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">get\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(resolved.version);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">При записи использовался тот же ключ:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> storage.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">set\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  version: resolved.version,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  data,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Пока на странице был один файл спрайта, этого было достаточно. Но такой ключ не описывал сам ресурс. Два загрузчика с разными файлами и одинаковой версией \u003Ccode>1.0\u003C\u002Fcode> могли обратиться к одной и той же записи.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Например:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'\u002Fadmin-icons.svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  version: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'1.0'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'\u002Fshop-icons.svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  version: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'1.0'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Раньше для хранилища это были два запроса к ключу \u003Ccode>1.0\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>5.0\u003C\u002Fcode> ключ кэша строится из URL файла и версии:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createCacheKey\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  file\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  version\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  baseUrl\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">)\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  try\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">    return\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> JSON\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">stringify\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">([\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> URL\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(file, baseUrl).href, version]);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">catch\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">    return\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> JSON\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">stringify\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">([file, version]);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">URL сначала нормализуется относительно \u003Ccode>ownerDocument.baseURI\u003C\u002Fcode>. Поэтому \u003Ccode>\u002Ficons.svg\u003C\u002Fcode> получает абсолютную форму с учётом базового URL документа. Если \u003Ccode>new URL()\u003C\u002Fcode> не срабатывает, ключ строится из исходных \u003Ccode>file\u003C\u002Fcode> и \u003Ccode>version\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для встроенных хранилищ это просто новый строковый ключ. С пользовательским \u003Ccode>IconStorage\u003C\u002Fcode> есть важная деталь: значение теперь нужно считать непрозрачным.\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> interface\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconStorage\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  get\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">key\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">)\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Promise\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">Result\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">IconRecord\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> |\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> undefined\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>>;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  set\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">record\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconRecord\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">)\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Promise\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">Result\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">void\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>>;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Поле \u003Ccode>IconRecord.version\u003C\u002Fcode> пока сохраняю, но при записи туда попадает уже составной ключ. То есть пользовательское хранилище не должно разбирать его как пользовательскую версию набора иконок.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Это одна из причин мажорного релиза. Ключ по-прежнему имеет тип \u003Ccode>string\u003C\u002Fcode>, но его смысл для пользовательского хранилища заметно изменился.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Ошибка чтения кэша больше не блокирует загрузку\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Следующий вопрос оказался важнее самого ключа.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В предыдущей схеме ошибка чтения останавливала \u003Ccode>init()\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> cacheResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> storage.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">get\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(resolved.version);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">cacheResult.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> fail\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(cacheResult.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Но если IndexedDB временно недоступен, зачем из-за этого отказываться от SVG, который можно получить обычным \u003Ccode>fetch()\u003C\u002Fcode>?\u003C\u002Fp>\n\u003Cp class=\"body-large\">Теперь ошибку чтения кэша обрабатываю отдельно:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">let\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> cacheAvailable \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">let\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> data\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> |\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> undefined\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">try\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> cacheResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> storage.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">get\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(cacheKey);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (cacheResult.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    data \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> cacheResult.value?.data;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">else\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    cacheAvailable \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> false\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    logError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(cacheResult.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">} \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">catch\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">error\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> unknown\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  cacheAvailable \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> false\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  logError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    createIconlyError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">      'storage_read_failed'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">      'Failed to read from icon storage.'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">      error,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    ),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  );\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Здесь я учитываю оба случая: пользовательское хранилище может вернуть \u003Ccode>Result\u003C\u002Fcode> с ошибкой, а может неожиданно бросить исключение или вернуть отклонённый Promise.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В обоих случаях ошибка остаётся видимой через \u003Ccode>onError\u003C\u002Fcode> и \u003Ccode>logger.error\u003C\u002Fcode>, но основной сценарий продолжается и переходит к сети.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Получается немного непривычная, но полезная ситуация:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> errors\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">[] \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> [];\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> iconLoader\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'\u002Ficons.svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  onError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: (\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> errors.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">push\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(error),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> result\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconLoader.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">init\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">В \u003Ccode>errors\u003C\u002Fcode> может оказаться ошибка с кодом \u003Ccode>storage_read_failed\u003C\u002Fcode>, а \u003Ccode>result.ok\u003C\u002Fcode> при этом может быть \u003Ccode>true\u003C\u002Fcode>, если SVG удалось скачать и вставить.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Это не означает, что ошибка кэша игнорируется. Я просто перестаю смешивать два разных результата: состояние оптимизации и результат основной операции.\u003C\u002Fp>\n\u003Cp class=\"body-large\">После неудачного чтения я не пытаюсь тут же делать \u003Ccode>set()\u003C\u002Fcode> в то же хранилище. На время текущего \u003Ccode>init()\u003C\u002Fcode> оно считается недоступным:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (cacheAvailable) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F storage.set(...)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Если чтение уже показало, что хранилище не работает как ожидается, дополнительная запись редко улучшит ситуацию.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Запись в кэш после вставки SVG\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Та же логика применяется к записи в кэш.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>4.2\u003C\u002Fcode> после \u003Ccode>fetch\u003C\u002Fcode> сначала выполнялся \u003Ccode>storage.set()\u003C\u002Fcode>. Если запись возвращала ошибку, \u003Ccode>init()\u003C\u002Fcode> завершался раньше вставки в DOM.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Теперь последовательность другая:\u003C\u002Fp>\n\u003Cpre class=\"shiki\">\u003Ccode>fetch\n  -&gt; подготовка SVG к вставке\n  -&gt; вставка в DOM\n  -&gt; запись в кэш\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Сначала SVG нужно успешно вставить в DOM. Только после этого я пытаюсь сохранить исходную строку в хранилище. Ниже показана обработка \u003Ccode>Result\u003C\u002Fcode>, возвращённого из \u003Ccode>storage.set()\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> insertResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> insertSvg\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  containerResult.value,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  fetchResult.value,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  { sanitize: resolved.sanitize },\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">insertResult.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> fail\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(insertResult.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (cacheAvailable) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> storeResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> storage.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">set\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    version: cacheKey,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    data: fetchResult.value,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">storeResult.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    logError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(storeResult.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ok\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">undefined\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">На практике это меняет две вещи.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Во-первых, если \u003Ccode>storage.set()\u003C\u002Fcode> возвращает \u003Ccode>Result\u003C\u002Fcode> с ошибкой, уже успешная загрузка и вставка не превращаются в \u003Ccode>ok: false\u003C\u002Fcode>. Пользователь получает иконки, а проблему с кэшем можно отдельно увидеть через обработчик ошибок.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Во-вторых, некорректный загруженный SVG не попадает в хранилище до проверки. Если разбор или вставка не удались, запись вообще не выполняется.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Мне нравится это правило больше прежнего — сохранять только то, что текущая цепочка уже смогла использовать.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Данные из кэша тоже приходится проверять\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Изменить момент записи в кэш оказалось недостаточно. В хранилище может лежать некорректная запись: из старой версии приложения, после ручного изменения или повреждения данных. Неожиданное содержимое может вернуть и пользовательская реализация хранилища.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Раньше найденная запись кэша воспринималась как готовый результат. Если сохранённая строка не разбиралась как SVG, \u003Ccode>insertSvg()\u003C\u002Fcode> возвращал \u003Ccode>parse_error\u003C\u002Fcode>, и на этом \u003Ccode>init()\u003C\u002Fcode> заканчивался.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Теперь загрузчик сначала пытается вставить SVG из кэша:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (data) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> insertResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> insertSvg\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(containerResult.value, data, {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    sanitize: resolved.sanitize,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (insertResult.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">    return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ok\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">undefined\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (insertResult.error.cause) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">    return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> fail\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(insertResult.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  logError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(insertResult.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Если строка не является валидным SVG-документом, ошибка логируется, а загрузчик переходит к сетевому запросу. Если свежий SVG удалось вставить, загрузчик пытается обновить запись в кэше.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Так повреждённая запись кэша становится состоянием, из которого можно восстановиться, а не тупиком.\u003C\u002Fp>\n\u003Cp class=\"body-large\">При этом я не хочу маскировать любое исключение под обычное отсутствие записи в кэше. В показанном коде ошибка вставки остаётся критической, если её \u003Ccode>cause\u003C\u002Fcode> приводится к \u003Ccode>true\u003C\u002Fcode> при проверке условия. Например, пользовательский санитайзер может бросить исключение. В таком случае молча скачать тот же SVG ещё раз — не восстановление, а сокрытие реальной проблемы в пользовательском коде.\u003C\u002Fp>\n\u003Cp class=\"body-large\">То есть запасной путь здесь довольно узкий: испорченный документ из кэша можно заменить свежим, критическую ошибку — нет.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Исключения не должны обходить Result\u003C\u002Fh2>\n\u003Cp class=\"body-large\">\u003Ccode>Result\u003C\u002Fcode> появился в \u003Ccode>3.0\u003C\u002Fcode>. Тогда же я зафиксировал, что штатные ошибки \u003Ccode>init()\u003C\u002Fcode> возвращаются через \u003Ccode>Result\u003C\u002Fcode>, а не выбрасываются наружу. Но исключения браузерных API и пользовательского кода всё ещё могли нарушить этот контракт.\u003C\u002Fp>\n\u003Cp class=\"body-large\">К \u003Ccode>5.0\u003C\u002Fcode> нашёл несколько таких мест.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Самый простой пример — некорректный CSS-селектор:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  container: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'['\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">\u003Ccode>document.querySelector('[')\u003C\u002Fcode> бросает \u003Ccode>DOMException\u003C\u002Fcode>. Если не перехватить это исключение, оно выходит за пределы \u003Ccode>Result\u003C\u002Fcode>-контракта.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Теперь \u003Ccode>resolveContainer()\u003C\u002Fcode> перехватывает исключение при поиске элемента и возвращает ошибку с кодом \u003Ccode>container_invalid\u003C\u002Fcode> через \u003Ccode>Result\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">try\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F document.querySelector(...)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">} \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">catch\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">error\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> unknown\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> err\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    createIconlyError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">      'container_invalid'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">      'Failed to resolve container.'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">      error,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    ),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  );\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">То же самое сделано вокруг разбора SVG и вставки в DOM.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Отдельный случай — пользовательские обработчики. Раньше такой код мог нарушить контракт ошибок самой библиотеки:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  onError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: () \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">    throw\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'reporter failed'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  },\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Теперь исключения обработчика и \u003Ccode>logger\u003C\u002Fcode> перехватываются отдельно:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">try\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  resolved.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">onError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">?.(error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">} \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">catch\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F callback не должен менять Result\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">try\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  resolved.logger?.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">?.(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'[Iconly error]'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">, error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">} \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">catch\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F logger тоже\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Для меня важно, чтобы ошибка в диагностическом обработчике не подменяла исходную ошибку \u003Ccode>init()\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Весь \u003Ccode>runInit()\u003C\u002Fcode> дополнительно обёрнут в \u003Ccode>try\u002Fcatch\u003C\u002Fcode>. Для неожиданного исключения добавлен код \u003Ccode>unexpected_error\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">try\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F основной init flow\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">} \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">catch\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">error\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> unknown\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> fail\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    createIconlyError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">      'unexpected_error'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#9ECBFF\">      'Unexpected error while initializing Iconly.'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">      error,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    ),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  );\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Аналогичная защита появилась у синхронного \u003Ccode>createSprite().render()\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Я не пытаюсь доказать, что JavaScript-среда в принципе больше никогда не сможет бросить исключение. Задача практичнее: ожидаемые браузерные API, пользовательское хранилище и обработчики не должны случайно обходить публичный \u003Ccode>Result\u003C\u002Fcode>-контракт.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Два одновременных init() — одна операция\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Ещё один сценарий обнаруживается, если вызвать \u003Ccode>init()\u003C\u002Fcode> дважды, пока первый запрос ещё выполняется.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Вместо двух независимых операций теперь экземпляр хранит текущий Promise:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">let\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> inFlight\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Promise\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">Result\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">void\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>> \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">|\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> null\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> null\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> init\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> ()\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Promise\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">Result\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">void\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>> \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">inFlight) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    inFlight \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> runInit\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">().\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">finally\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(() \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">      controller \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> null\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">      inFlight \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> null\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">    });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> inFlight;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Параллельные вызовы получают один и тот же Promise:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> first\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconLoader.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">init\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> second\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconLoader.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">init\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">console.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">log\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(first \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">===\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> second); \u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">\u002F\u002F true\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Во время активной загрузки \u003Ccode>abort()\u003C\u002Fcode> отменяет общий запрос этого экземпляра, а не один из нескольких параллельных запросов.\u003C\u002Fp>\n\u003Cp class=\"body-large\">После завершения \u003Ccode>inFlight\u003C\u002Fcode> сбрасывается, и следующий \u003Ccode>init()\u003C\u002Fcode> снова может выполнить обычную операцию.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Открытие существующей базы IndexedDB\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В адаптере поправил ещё один сценарий. Раньше база IndexedDB открывалась с фиксированной версией \u003Ccode>1\u003C\u002Fcode>. Это было неудобно, если база с таким \u003Ccode>dbName\u003C\u002Fcode> уже существовала, но пользователь выбирал другой \u003Ccode>storeName\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Теперь адаптер сначала открывает существующую базу без принудительной версии. Если нужного хранилища объектов нет, соединение закрывается, номер версии увеличивается и хранилище создаётся через \u003Ccode>onupgradeneeded\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Кроме того, соединение закрывается на \u003Ccode>versionchange\u003C\u002Fcode>, а отклонённый \u003Ccode>dbPromise\u003C\u002Fcode> сбрасывается, чтобы следующая попытка могла снова открыть базу.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Это не меняет публичный API хранилища, но соответствует тому же принципу релиза: хранилище не должно быть хрупким только потому, что окружение оказалось чуть сложнее идеального тестового сценария.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Что теперь означает ok: true\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>5.0\u003C\u002Fcode> внешний код по-прежнему выглядит знакомо:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> iconLoader\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'\u002Ficons.svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  version: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'1.0'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> result\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconLoader.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">init\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">result.ok) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  console.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(result.error);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Но смысл \u003Ccode>result.ok\u003C\u002Fcode> теперь точнее.\u003C\u002Fp>\n\u003Cp class=\"body-large\">\u003Ccode>ok: true\u003C\u002Fcode> означает, что спрайт удалось получить и вставить. Это не обещание, что попутно идеально сработал кэш. Восстановимая ошибка хранилища может быть отдельно отправлена в \u003Ccode>onError\u003C\u002Fcode> или \u003Ccode>logger\u003C\u002Fcode>, не меняя успешный результат основной операции.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Раньше хранилище было вынесено в отдельную абстракцию, но ядро всё ещё относилось к нему как к обязательной части успеха. Теперь зависимость стала честнее: кэш ускоряет следующий запуск, когда доступен, и отходит в сторону, когда нет.\u003C\u002Fp>\n",1795172788624]