[{"data":1,"prerenderedAt":206},["ShallowReactive",2],{"journal-all":3,"journal-post-delaem-api-iconly-predskazuemym":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":105,"documentId":106,"title":107,"content":203,"slug":108,"author":9,"displayDate":109,"publishedAt":110,"tags":204,"html":205},"В `2.0` в основном приводил в порядок внутреннее устройство iconly, сохраняя прежний способ использования. В `3.0` занялся публичным API. Я хотел, чтобы по результату инициализации было понятно, что произошло, а отдельные части библиотеки можно было подменять и тестировать.\n\nЗаодно это часть общей работы по унификации моих библиотек. Мне нужен единый подход к API: явные результаты операций, небольшой публичный интерфейс и заменяемые зависимости там, где это действительно полезно.\n\nВ `3.0.0` `new Iconly()` уступил место `createIconly()`, `init()` начал возвращать `Result`, а хранилище получило собственный интерфейс. Основную реализацию я разделил на несколько модулей: ядро, работа с DOM, загрузка, ошибки и адаптеры хранилища.\n\n## Явный результат инициализации\n\nВ `2.0.1` вызов выглядел просто:\n\n```ts\nimport Iconly from 'iconly';\n\nconst iconly = new Iconly({\n  file: '.\u002Fsprite.svg',\n  version: '1.0',\n});\n\nawait iconly.init();\n```\n\nНо из результата вызова было невозможно понять, загрузился ли спрайт. `init()` возвращал `Promise\u003Cvoid>`, а ошибки выполнения обрабатывались внутри библиотеки. Для небольшой утилиты этого достаточно. Я хотел явно различать ошибки контейнера, загрузки, хранилища и разбора SVG, чтобы пользователю не приходилось угадывать результат по состоянию DOM.\n\nВ `3.0` результат стал частью API:\n\n```ts\nimport { createIconly } from 'iconly';\n\nconst iconLoader = createIconly({\n  file: '.\u002Fsprite.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Сам тип очень небольшой:\n\n```ts\nexport type Result\u003CT> =\n  | { ok: true; value: T }\n  | { ok: false; error: IconlyError };\n```\n\nДля `init()` это фактически `Promise\u003CResult\u003Cvoid>>`. У вызывающего кода теперь есть два явных состояния, и TypeScript различает их по `ok`.\n\n## Ошибка тоже становится данными\n\nОдного `ok: false` мало, если дальше всё равно приходится разбирать текст сообщения. Поэтому у ошибки появилась собственная форма:\n\n```ts\nexport interface IconlyError {\n  code: IconlyErrorCode;\n  message: string;\n  cause?: unknown;\n}\n```\n\nВ текущем релизе используются такие коды:\n\n```ts\ntype IconlyErrorCode =\n  | 'container_invalid'\n  | 'fetch_aborted'\n  | 'fetch_failed'\n  | 'indexeddb_not_supported'\n  | 'indexeddb_open_failed'\n  | 'indexeddb_request_failed'\n  | 'parse_error'\n  | 'storage_read_failed'\n  | 'storage_unavailable'\n  | 'storage_write_failed';\n```\n\nТеперь вызывающий код может реагировать на категорию ошибки, а не на формулировку сообщения:\n\n```ts\nconst result = await iconLoader.init();\n\nif (!result.ok && result.error.code === 'fetch_aborted') {\n  \u002F\u002F запрос был отменён\n}\n```\n\nТот же `Result` проходит через внутренние части библиотеки. `fetchSvg()` возвращает `Result\u003Cstring>`, вставка SVG возвращает `Result\u003Cvoid>`, адаптеры хранилища возвращают `Result` из `get()` и `set()`.\n\nТак ядро может последовательно выполнять операции и проверять их результаты в одном формате.\n\n## Диагностику можно подключить к приложению\n\nДиагностику теперь тоже можно явно подключить к приложению:\n\n```ts\nconst iconLoader = createIconly({\n  onError: (error) => reportError(error),\n  onDebug: (...messages) => debugLog(...messages),\n  logger: {\n    debug: (...messages) => console.debug(...messages),\n    error: (...messages) => console.error(...messages),\n  },\n});\n```\n\nПри этом колбэки не заменяют `Result`. Ошибка передаётся в `onError` и `logger.error`, но `init()` всё равно возвращает тот же объект ошибки вызывающему коду.\n\n`debug` управляет только отладочными сообщениями. Ошибки остаются отдельным каналом и не исчезают из-за `debug: false`.\n\nДля меня это важное разделение. Результат операции нужен программе. `logger` и колбэки нужны для диагностики.\n\n## Фабричная функция вместо публичного класса\n\nВместе с новым контрактом ошибок я убрал публичный конструктор:\n\n```ts\nconst iconLoader = createIconly(config);\n```\n\nФабричная функция возвращает небольшой объект:\n\n```ts\nexport interface IconlyInstance {\n  init: () => Promise\u003CResult\u003Cvoid>>;\n  abort: () => void;\n}\n```\n\nМне важна не сама замена синтаксиса `new` на функцию. Я хочу, чтобы публичный API описывал доступные операции, а не устройство класса.\n\nВторой метод, `abort()`, отменяет уже начавшийся `fetch`. Внутри `createIconly()` хранится `AbortController`, а отменённый запрос превращается в обычный результат с кодом `fetch_aborted`. Пока `init()` читает кэш, запрос может ещё не начаться, поэтому немедленный вызов `abort()` после `init()` не гарантирует отмену.\n\nНапример, отмену активного запроса можно привязать к кнопке:\n\n```html\n\u003Cbutton id=\"cancel-icons\" type=\"button\">Отменить загрузку\u003C\u002Fbutton>\n```\n\n```ts\nimport { createIconly } from 'iconly';\n\nconst iconLoader = createIconly({ file: '.\u002Fsprite.svg' });\nconst cancelButton = document.querySelector\u003CHTMLButtonElement>('#cancel-icons')!;\n\ncancelButton.addEventListener('click', () => iconLoader.abort());\n\nconst result = await iconLoader.init();\n```\n\n## Хранилище можно заменить\n\nВ ранних версиях iconly хранилище и основная логика были почти одним целым. В `3.0` я отделил работу с хранилищем от ядра, оставив IndexedDB вариантом по умолчанию.\n\nДля этого появился публичный интерфейс:\n\n```ts\nexport interface IconStorage {\n  get(version: string): Promise\u003CResult\u003CIconRecord | undefined>>;\n  set(record: IconRecord): Promise\u003CResult\u003Cvoid>>;\n}\n```\n\nА опция `storage` принимает несколько стратегий:\n\n```ts\nexport type StorageStrategy =\n  | 'indexeddb'\n  | 'memory'\n  | 'session'\n  | IconStorage;\n```\n\nВстроенных вариантов три:\n\n```ts\ncreateIconly({ storage: 'indexeddb' });\ncreateIconly({ storage: 'memory' });\ncreateIconly({ storage: 'session' });\n```\n\nЧетвёртый вариант — собственная реализация `IconStorage`.\n\nДля меня это особенно важно при тестировании. Ядро работает через `get()` и `set()`, а детали хранилища остаются в его реализации. Для теста основного сценария можно выбрать хранилище в памяти и обойтись без IndexedDB. Сам адаптер IndexedDB можно проверить отдельно в контролируемой среде.\n\n## Чтение кэша перед загрузкой SVG\n\nДо `3.0` IndexedDB уже использовался, но сама последовательность была неидеальной: iconly сначала выполнял `fetch()`, а потом читал сохранённую запись. Получалось, что кэш не мог убрать сетевой запрос.\n\nПосле разделения хранилища я изменил порядок операций. Сокращённая схема, без проверок `Result` и обработки ошибок:\n\n```ts\nconst cacheResult = await storage.get(resolved.version);\nlet data = cacheResult.value?.data;\n\nif (!data) {\n  const fetchResult = await fetchSvg(resolved.file, controller.signal);\n  data = fetchResult.value;\n\n  await storage.set({\n    version: resolved.version,\n    data,\n  });\n}\n```\n\nСначала читается хранилище. Если сохранённых SVG-данных нет, выполняется `fetch`.\n\nПовторная инициализация с той же версией теперь может обойтись без сети.\n\nЗакрепил это тестом. Первый экземпляр загружает `\u002Fsprite.svg` и записывает данные в IndexedDB. Второй использует ту же базу и ту же версию. Тест проверяет, что оба `init()` завершаются успешно, а подменённый `fetch` вызывается только один раз.\n\n```ts\nexpect(firstResult.ok).toBe(true);\nexpect(fetchMock).toHaveBeenCalledTimes(1);\n\nconst secondResult = await second.init();\n\nexpect(secondResult.ok).toBe(true);\nexpect(fetchMock).toHaveBeenCalledTimes(1);\n```\n\n## Проверка основных сценариев\n\nВ `3.0` у пакета появился набор тестов на Vitest, `jsdom` и `fake-indexeddb`.\n\nПростой DOM-сценарий можно проверить через хранилище в памяти:\n\n```ts\nconst iconly = createIconly({\n  storage: 'memory',\n  file: '\u002Fsprite.svg',\n  version: '1.0',\n  container,\n});\n\nconst result = await iconly.init();\n\nexpect(result.ok).toBe(true);\nexpect(container.querySelector('[data-iconly=\"iconset\"] svg')).not.toBeNull();\n```\n\nДля IndexedDB отдельный тест использует `fake-indexeddb` и проверяет чтение из кэша.\n\nКонтракт `Result` позволяет проверять исход операции напрямую, а сменное хранилище — тестировать основной сценарий без IndexedDB.\n\nВ `package.json` заодно появилась общая команда проверки:\n\n```json\n{\n  \"verify\": \"yarn lint && yarn typecheck && yarn test\"\n}\n```\n\n## Разделение на модули\n\nДо этого основная реализация жила в `src\u002Findex.ts`. В `3.0` структура стала такой:\n\n```text\nsrc\u002F\n  core.ts\n  dom.ts\n  errors.ts\n  fetcher.ts\n  index.ts\n  result.ts\n  storage\u002F\n    index.ts\n    indexeddb.ts\n    memory.ts\n    session.ts\n  types.ts\n```\n\n`index.ts` теперь в основном задаёт публичные экспорты. `core.ts` управляет последовательностью операций. Вставка в DOM, загрузка, вспомогательные функции `Result` и разные реализации хранилища находятся в отдельных модулях.\n\nДля меня важно, что модули соответствуют контрактам в коде: хранилище можно заменить, загрузка и вставка в DOM возвращают `Result`, а публичные типы экспортируются из одной точки. Такую структуру проще проверять и менять.\n\n## Мажорный релиз всё равно требует миграции\n\nПредсказуемый API не означает полностью совместимый API. В `3.0` есть несколько намеренных несовместимых изменений.\n\nГлавное — перейти с конструктора на фабричную функцию и проверять результат `init()`:\n\n```ts\n\u002F\u002F 2.x\nconst iconly = new Iconly(options);\nawait iconly.init();\n\n\u002F\u002F 3.x\nconst iconly = createIconly(options);\nconst result = await iconly.init();\n\nif (!result.ok) {\n  \u002F\u002F обработать result.error\n}\n```\n\nПоменялся и селектор обёртки спрайта. В выбранном контейнере создаётся элемент с `data-iconly` вместо прежнего `#iconset`:\n\n```html\n\u003Cdiv data-iconly=\"iconset\" aria-hidden=\"true\">...\u003C\u002Fdiv>\n```\n\nВнутренний селектор больше не опирается на глобальный `id`. Атрибут `aria-hidden=\"true\"` исключает служебную обёртку из дерева доступности.",[],"\u003Cp class=\"body-large\">В \u003Ccode>2.0\u003C\u002Fcode> в основном приводил в порядок внутреннее устройство iconly, сохраняя прежний способ использования. В \u003Ccode>3.0\u003C\u002Fcode> занялся публичным API. Я хотел, чтобы по результату инициализации было понятно, что произошло, а отдельные части библиотеки можно было подменять и тестировать.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Заодно это часть общей работы по унификации моих библиотек. Мне нужен единый подход к API: явные результаты операций, небольшой публичный интерфейс и заменяемые зависимости там, где это действительно полезно.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>3.0.0\u003C\u002Fcode> \u003Ccode>new Iconly()\u003C\u002Fcode> уступил место \u003Ccode>createIconly()\u003C\u002Fcode>, \u003Ccode>init()\u003C\u002Fcode> начал возвращать \u003Ccode>Result\u003C\u002Fcode>, а хранилище получило собственный интерфейс. Основную реализацию я разделил на несколько модулей: ядро, работа с DOM, загрузка, ошибки и адаптеры хранилища.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Явный результат инициализации\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>2.0.1\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\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> Iconly \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly'\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\"> iconly\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Iconly\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\">'.\u002Fsprite.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\">await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconly.\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>init()\u003C\u002Fcode> возвращал \u003Ccode>Promise&lt;void&gt;\u003C\u002Fcode>, а ошибки выполнения обрабатывались внутри библиотеки. Для небольшой утилиты этого достаточно. Я хотел явно различать ошибки контейнера, загрузки, хранилища и разбора SVG, чтобы пользователю не приходилось угадывать результат по состоянию DOM.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>3.0\u003C\u002Fcode> результат стал частью API:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { createIconly } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly'\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\">'.\u002Fsprite.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\">Сам тип очень небольшой:\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\"> type\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Result\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">T\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">> \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { \u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">ok\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">; \u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">value\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> T\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { \u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">ok\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> false\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">; \u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">error\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyError\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>init()\u003C\u002Fcode> это фактически \u003Ccode>Promise&lt;Result&lt;void&gt;&gt;\u003C\u002Fcode>. У вызывающего кода теперь есть два явных состояния, и TypeScript различает их по \u003Ccode>ok\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Ошибка тоже становится данными\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Одного \u003Ccode>ok: false\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\"> IconlyError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  code\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyErrorCode\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  message\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\">  cause\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\">}\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\">type\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyErrorCode\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'container_invalid'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'fetch_aborted'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'fetch_failed'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'indexeddb_not_supported'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'indexeddb_open_failed'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'indexeddb_request_failed'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'parse_error'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'storage_read_failed'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'storage_unavailable'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'storage_write_failed'\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\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\"> 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>\u003Cspan style=\"color:#F97583\">&#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> result.error.code \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">===\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'fetch_aborted'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F запрос был отменён\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> проходит через внутренние части библиотеки. \u003Ccode>fetchSvg()\u003C\u002Fcode> возвращает \u003Ccode>Result&lt;string&gt;\u003C\u002Fcode>, вставка SVG возвращает \u003Ccode>Result&lt;void&gt;\u003C\u002Fcode>, адаптеры хранилища возвращают \u003Ccode>Result\u003C\u002Fcode> из \u003Ccode>get()\u003C\u002Fcode> и \u003Ccode>set()\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Так ядро может последовательно выполнять операции и проверять их результаты в одном формате.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Диагностику можно подключить к приложению\u003C\u002Fh2>\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\"> 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:#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:#B392F0\"> reportError\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(error),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  onDebug\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">...\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">messages\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> debugLog\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">...\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">messages),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  logger: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    debug\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">...\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">messages\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> console.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">debug\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">...\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">messages),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">    error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">...\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">messages\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> console.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">error\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">...\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">messages),\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>. Ошибка передаётся в \u003Ccode>onError\u003C\u002Fcode> и \u003Ccode>logger.error\u003C\u002Fcode>, но \u003Ccode>init()\u003C\u002Fcode> всё равно возвращает тот же объект ошибки вызывающему коду.\u003C\u002Fp>\n\u003Cp class=\"body-large\">\u003Ccode>debug\u003C\u002Fcode> управляет только отладочными сообщениями. Ошибки остаются отдельным каналом и не исчезают из-за \u003Ccode>debug: false\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для меня это важное разделение. Результат операции нужен программе. \u003Ccode>logger\u003C\u002Fcode> и колбэки нужны для диагностики.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Фабричная функция вместо публичного класса\u003C\u002Fh2>\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\"> iconLoader\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(config);\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\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> interface\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconlyInstance\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\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>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  abort\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> () \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\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>new\u003C\u002Fcode> на функцию. Я хочу, чтобы публичный API описывал доступные операции, а не устройство класса.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Второй метод, \u003Ccode>abort()\u003C\u002Fcode>, отменяет уже начавшийся \u003Ccode>fetch\u003C\u002Fcode>. Внутри \u003Ccode>createIconly()\u003C\u002Fcode> хранится \u003Ccode>AbortController\u003C\u002Fcode>, а отменённый запрос превращается в обычный результат с кодом \u003Ccode>fetch_aborted\u003C\u002Fcode>. Пока \u003Ccode>init()\u003C\u002Fcode> читает кэш, запрос может ещё не начаться, поэтому немедленный вызов \u003Ccode>abort()\u003C\u002Fcode> после \u003Ccode>init()\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:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">button\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> id\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"cancel-icons\"\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> type\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"button\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>Отменить загрузку&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">button\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> { createIconly } \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">from\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'iconly'\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\">({ file: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'.\u002Fsprite.svg'\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\"> cancelButton\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> document.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">querySelector\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">HTMLButtonElement\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'#cancel-icons'\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:#E1E4E8\">cancelButton.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">addEventListener\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'click'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">, () \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconLoader.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">abort\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\"> 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>\u003Ch2 class=\"headline-medium\">Хранилище можно заменить\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В ранних версиях iconly хранилище и основная логика были почти одним целым. В \u003Ccode>3.0\u003C\u002Fcode> я отделил работу с хранилищем от ядра, оставив IndexedDB вариантом по умолчанию.\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\">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\">version\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>storage\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\"> type\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> StorageStrategy\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'indexeddb'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'memory'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'session'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> IconStorage\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\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\">({ storage: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'indexeddb'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({ storage: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'memory'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({ storage: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'session'\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>IconStorage\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для меня это особенно важно при тестировании. Ядро работает через \u003Ccode>get()\u003C\u002Fcode> и \u003Ccode>set()\u003C\u002Fcode>, а детали хранилища остаются в его реализации. Для теста основного сценария можно выбрать хранилище в памяти и обойтись без IndexedDB. Сам адаптер IndexedDB можно проверить отдельно в контролируемой среде.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Чтение кэша перед загрузкой SVG\u003C\u002Fh2>\n\u003Cp class=\"body-large\">До \u003Ccode>3.0\u003C\u002Fcode> IndexedDB уже использовался, но сама последовательность была неидеальной: iconly сначала выполнял \u003Ccode>fetch()\u003C\u002Fcode>, а потом читал сохранённую запись. Получалось, что кэш не мог убрать сетевой запрос.\u003C\u002Fp>\n\u003Cp class=\"body-large\">После разделения хранилища я изменил порядок операций. Сокращённая схема, без проверок \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\">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\">\u003Cspan style=\"color:#F97583\">let\u003C\u002Fspan>\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\">\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\">data) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> fetchResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> fetchSvg\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(resolved.file, controller.signal);\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\"> fetchResult.value;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\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\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Сначала читается хранилище. Если сохранённых SVG-данных нет, выполняется \u003Ccode>fetch\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Повторная инициализация с той же версией теперь может обойтись без сети.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Закрепил это тестом. Первый экземпляр загружает \u003Ccode>\u002Fsprite.svg\u003C\u002Fcode> и записывает данные в IndexedDB. Второй использует ту же базу и ту же версию. Тест проверяет, что оба \u003Ccode>init()\u003C\u002Fcode> завершаются успешно, а подменённый \u003Ccode>fetch\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:#B392F0\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(firstResult.ok).\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">toBe\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(fetchMock).\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">toHaveBeenCalledTimes\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">1\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\"> secondResult\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> second.\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:#B392F0\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(secondResult.ok).\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">toBe\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(fetchMock).\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">toHaveBeenCalledTimes\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">1\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2 class=\"headline-medium\">Проверка основных сценариев\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>3.0\u003C\u002Fcode> у пакета появился набор тестов на Vitest, \u003Ccode>jsdom\u003C\u002Fcode> и \u003Ccode>fake-indexeddb\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Простой DOM-сценарий можно проверить через хранилище в памяти:\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\"> iconly\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\">  storage: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'memory'\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\">'\u002Fsprite.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\">  container,\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\"> iconly.\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:#B392F0\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(result.ok).\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">toBe\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(container.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">querySelector\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'[data-iconly=\"iconset\"] svg'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">)).not.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">toBeNull\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Для IndexedDB отдельный тест использует \u003Ccode>fake-indexeddb\u003C\u002Fcode> и проверяет чтение из кэша.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Контракт \u003Ccode>Result\u003C\u002Fcode> позволяет проверять исход операции напрямую, а сменное хранилище — тестировать основной сценарий без IndexedDB.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В \u003Ccode>package.json\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:#E1E4E8\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  \"verify\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"yarn lint &#x26;&#x26; yarn typecheck &#x26;&#x26; yarn test\"\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>\u003Ch2 class=\"headline-medium\">Разделение на модули\u003C\u002Fh2>\n\u003Cp class=\"body-large\">До этого основная реализация жила в \u003Ccode>src\u002Findex.ts\u003C\u002Fcode>. В \u003Ccode>3.0\u003C\u002Fcode> структура стала такой:\u003C\u002Fp>\n\u003Cpre class=\"shiki\">\u003Ccode>src\u002F\n  core.ts\n  dom.ts\n  errors.ts\n  fetcher.ts\n  index.ts\n  result.ts\n  storage\u002F\n    index.ts\n    indexeddb.ts\n    memory.ts\n    session.ts\n  types.ts\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">\u003Ccode>index.ts\u003C\u002Fcode> теперь в основном задаёт публичные экспорты. \u003Ccode>core.ts\u003C\u002Fcode> управляет последовательностью операций. Вставка в DOM, загрузка, вспомогательные функции \u003Ccode>Result\u003C\u002Fcode> и разные реализации хранилища находятся в отдельных модулях.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для меня важно, что модули соответствуют контрактам в коде: хранилище можно заменить, загрузка и вставка в DOM возвращают \u003Ccode>Result\u003C\u002Fcode>, а публичные типы экспортируются из одной точки. Такую структуру проще проверять и менять.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Мажорный релиз всё равно требует миграции\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Предсказуемый API не означает полностью совместимый API. В \u003Ccode>3.0\u003C\u002Fcode> есть несколько намеренных несовместимых изменений.\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:#6A737D\">\u002F\u002F 2.x\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> iconly\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Iconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(options);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> iconly.\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:#6A737D\">\u002F\u002F 3.x\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> iconly\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> createIconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(options);\u003C\u002Fspan>\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\"> iconly.\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:#6A737D\">  \u002F\u002F обработать 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>data-iconly\u003C\u002Fcode> вместо прежнего \u003Ccode>#iconset\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:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> data-iconly\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"iconset\"\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> aria-hidden\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">=\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">\"true\"\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>...&#x3C;\u002F\u003C\u002Fspan>\u003Cspan style=\"color:#85E89D\">div\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>id\u003C\u002Fcode>. Атрибут \u003Ccode>aria-hidden=&quot;true&quot;\u003C\u002Fcode> исключает служебную обёртку из дерева доступности.\u003C\u002Fp>\n",1795172791304]