Главная » Разработка » Официальные версии

.URL+ RU : UniMax : 2025.4.24

Бармалей 24.04.2025 29.04.2025 260.0

Оптимизация и "осовременивание" кода, добавлены новые функции и настройки.
Первая версия с функциями манифеста MV3, сохранена полная обратная совместимость кода.
Применяется универсальный код, работающий в любых движках от CR31 до CR132.Ранее эта линейка называлась "Omnibox", теперь ребрэндирована* в "UniMax" – более логичное короткое название, отражающее полный набор вариантов вызова основной функции.* С апреля 2025 года линейка "Omnibox" снята с поддержки в связи с нецелесообразностью дальнейшей отдельной разработки.Вызов функции создания файла ярлыка в этой версии доступен:

через контекстное меню страницы (рекомендуемый вариант, работает даже в полноэкранном режиме);

по щелчку на значке в омнибоксе (для движков CR31-CR62, если поддерживается браузером);

по щелчку на значке на тулбаре (от CR49 вплоть до самых современных браузеров);

по горячей клавише (для любителей "топтать батоны" вместо "тыков мышом")).

Проверка работоспособности:

версии MV2/CRX2: SRWare Iron 31/48 + Chromium GOST 49 + 360 Extreme Explorer 11/12/13 (CR69/78/86);

версии MV2/CRX3: 360 Extreme Explorer 9.5/11/12/13 (CR63/69/78/86) + Chromium x32 109/122/132;

версии MV3: Chromium GOST x32 109 + Thorium x32 122 + Supermium x32 132.

Основные изменения:

главное изменение – отработка концепции "один код" под разные версии манифеста (MV2/MV3);

Концепция направлена на повышение удобства разработки последующих версий путём изменения "универсального" исходного кода и с целью минимизации затрат на выпуск релизов .URL+ под разные линейки и версии браузеров.

Связано с различием реализации части функций и API расширения в зависимости от версии манифеста. В частности – связано с отличием API кода для создания файла ярлыка и API хранения настроек.

При доработках кода решена основная задача его прямой и обратной совместимости под версии браузера от CR31 (проверено на SRWare Iron) до CR132 (проверено на Supermium x32).

Кроме того, продолжен выпуск версий с манифестом MV2 в формате CRXv3 (работают в браузерах версий от CR63–72 и вплоть до текущих CR132). Эти версии имеют полный функционал и позволяют применять более гибкую систему управления новыми настройками (см.далее).

В результате указанного подхода работоспособность основного кода аддона не зависит от "упаковки", установочные файлов релизов с разными форматами (CRXv2/v3) отличаются только заголовком и файлами манифестов с частными директивами под соответствующие версии (MV2/MV3).

Некоторая "избыточность" кода (теперь в нём присутствуют варианты как только для MV2, так и только для MV3) практически не приводит к снижению производительности. Кроме того, общая скорость работы аддона в целом повышена за счёт специальной оптимизации исходного кода (см.далее).

Попутно решена задача минимизации проверок/переходов в функциях аддона, зависящих от разных версий манифеста, а также задача обкатки "универсального" и компактного кода таких проверок.

в варианте аддона с манифестом MV3 применён другой метод формирования файла ярлыка для сохранения;

В этой версии файл ярлыка создаётся не в фоновом скрипте аддона, а посредством инжектирования кода на просматриваемую страницу с автоматическим запуском его выполнения. Это связано с невозможностью* прямой работы с html‑элементами в фоновом скрипте сервис‑воркера. Этот метод имеет ряд ограничений, однако является наиболее простым в реализации функции сохранения в MV3‑варианте.

* Я в курсе за API offscreen и/или автоинжекцию в сочетании с runtime.sendMessage, но "морально не готов" наворачивать лишний код ради выполнения простейшей функции, которая без проблем работает в MV2‑аддонах. Поэтому, если вам указанные ограничения критичны, могу предложить только одно – не ставьте MV3‑вариант, юзайте "классику" и всё будет хорошо… :)

исправлена проблема обработки горячих клавиш, приводившая к отказу от установки в браузерах CR72+;

Не являлось "багом" расширения, связано с изменением синтаксиса API chrome.commands, начиная от версий CR72+ (уже после выпуска предыдущей версии в мае 2018). Исправлено. Теперь аддон нормально устанавливается и вызов хоткея корректно работает в любых браузерах, от CR31 до CR132.

добавлена* новая настройка – оперативное переключение вызова горячей клавиши через меню;

По умолчанию включена, хоткей доступен для вызова. Отключение настройки позволяет быстро выключить (или включить) реакцию на нажатие горячей клавиши БЕЗ перехода в настройки браузера (раздел "Быстрые клавиши" для расширений).

Настройка добавлена чисто для удобства и оперативности, может потребоваться, если, например, в вашем браузере есть конфликт между хоткеями для разных расширений. Также позволяет быстро отключить обработку хоткея (и связанные с ним функции), если вы в принципе не используете эту возможность.

добавлена* новая настройка – оперативное переключение режима быстрой выгрузки фонового скрипта;

По умолчанию включена в версиях с MV2, как и было в предыдущей версии. Эта опция принудительно выключена и недоступна для изменения в версии с MV3, где отсутствует принципиальная возможность форсированной выгрузки сервис‑воркера.

Эта функция управления добавлена для ускорения вызова диалога сохранения, если вы часто сохраняете несколько ярлыков подряд (при отключении настройки скрипт не выгружается сразу же, задержка от 10 секунд и более).

В общем, эта фича тоже чисто для удобства. :)

добавлена* новая настройка – ограничение длины имени сохраняемого ярлыка (не более 50 символов);

По умолчанию включена, в версиях MV3 применяется принудительно (недоступна для отключения, связано с избыточной сложностью передачи параметров в скрипт‑инжектор). При этом имена файлов ярлыков (формируемые на основе заголовков сохраняемых страниц) не будут превышать 54 символов: 50 – имя файла + 4 – расширение (.url).

Добавлено для дополнительной защиты от последующей недоступности сохранённых ярлыков, если они сохраняются по "ну о‑очень длинному" пути. Также связано с тем, что на многих современных сайтах заголовок страниц бывает достаточно громоздкий и эта "колбаса" совершенно неудобочитаема потом в файловых менеджерах.

Если выключено (только в версиях версиях с MV2) – длина имени файла при сохранении никак не ограничивается (как и было в предыдущей версии расширения), все (возможные) проблемы из‑за "сверхдлинных" имён решаются пользователем самостоятельно.

В любом случае, независимо от состояния этой настройки, вы всегда можете вручную изменить автоматически сформированное имя файла ярлыка, указав его в диалоге сохранения.

В общем, и эта фича тоже чисто для удобства. :)

добавлена* новая группа – переходы к документации по расширению (ссылки на этот сайт);

Добавлено, опять же, для удобства, можно быстро проверить обновление версии или прочитать справку (хотя, вроде бы, и так всё должно быть понятно)). Короче говоря, теперь вся связанная "дока" будет у вас "под рукой". :)

изменён способ отображения* настроек в меню – теперь они отображаются независимо от версии браузера;

В предыдущей версии меню настроек отображалось только для кнопки в омнибоксе (CR48–CR62) или для значка на тулбаре (в CR49+ в зависимости от браузера, в CR63+ только там, "бай дизайн").

Теперь оно также выводится в меню страницы на служебных вкладках (включая собственные страницы любых установленных расширений, по маске адреса chrome*://*) в браузерах, не поддерживающих параметр контекста ["page_action"] (CR31–CR47). При этом в "старых" браузерах на всех остальных вкладках вложенное подменю с настройками и ссылками отсутствует, чтобы "не засорять контекст" (как и в предыдущих версиях .URL+, на веб‑страницах всегда отображается только пункт меню сохранения ярлыка).

Таким образом снято ограничение по версии браузера, теперь полноценное управление настройками доступно в браузерах любых версий, независимо от "древности" их движка.

Важное примечание: при использовании "старых" браузеров (CR31–CR47) пункт отключения контекстного меню относится только к веб‑страницам (как и в предыдущих версиях .URL+), на страницах chrome*://* меню отображается в любом** случае и у вас всегда будет доступ к управлению настройками аддона. При этом, конечно же, создание ярлыка служебных страниц через контекстное меню будет невозможно (если отключено, этот пункт просто отсутствует в списке действий меню).

** Упреждая вопрос "а почему бы не отключать меню полностью на всех страницах в старых арбузах?" – а зачем? Если юзер НЕ хочет видеть меню на веб‑страницах – нужно дать ему такую возможность.) Если отключить ещё и хоткей, сохранить ярлык всё равно можно – кнопка‑то в омнибоксе в любом случае останется! Но при этом юзер вправе передумать и, в любой момент, снова включить создание ярлыка через контекстное меню (или по хоткею) БЕЗ необходимости переустановки аддона… :)

существенно изменён, переработан и "осовременен" код большинства функций расширения;

Направлено на оптимизацию кода по скорости выполнения, убраны дублирующие переходы, "лишние" переменные. Часть повторяющихся (с некоторыми отличиями) функций преобразована в общие с вызовом с параметрами. Укорочены циклы создания контекстного меню, повышена "отзывчивость" интерфейса.

в манифесте изменено ограничение по версии браузера: вместо 25+ теперь 31+.

Сделано во избежание неоправданного усложнения кода проверок для определения функциональных возможностей движка вашего текущего браузера (необходимо для построения меню и правильной отрисовки значка в омнибоксе в CR31-CR62). Для этого применяется упрощённая проверка, очень быстрая и корректно работающая в движках от CR31 до CR132, в более старых движках (например, CR29) она приводит к ошибке и потребует дополнительных функций.

В общем, это на тот случай, если вдруг кто‑то захочет опробовать "юнимакса" на совсем уж древних версиях… %)

* Назначение каждого пункта понятно из его названия, для наглядности смотрим скриншоты ниже.

Прочие изменения:

добавлена задержка для функции быстрой автовыгрузки фонового скрипта (100 мс);

Влияет только на MV2‑версии. Сделано с целью повышения устойчивости работы и гарантированной отработки всех асинхронных функций (например, при первой установке или при обновлении).

скрипт-инжектор для открытия *.URL-файлов доработан и уменьшен* почти вдвое;

* Был – 126 байт, стал – 73 байта…)

в установочный комплект аддона теперь входят сжатые версии всех JS‑файлов.

Сделано с целью уменьшения их размера для общего ускорения загрузки окон аддона при их вызове. За счёт оптимизации кода, включая все указанные выше переделки функций и действий, а также с учётом добавленных функций и элементов интерфейса, рабочий размер установленного аддона практически не изменился (был – 4.5кБ, стал – 4.9кБ))).

Примечание для интересующихся – в публичном варианте исходного кода, соответствующего текущей версии (по системе LBSC), компрессия НЕ используется, все файлы оставлены "как есть", включая все комментарии и "отложенные на потом" фрагменты кода.

Примечания по обновлению версии: Независимо от версии браузера и/или выбранного вами типа установщика – при обновлении аддона поверх любой из линеек базовой версии (2018.5.5):

При обновлении любой MV2‑версии будет сброшена настройка, отключающая показ контекстного меню на странице (если, конечно, вы её меняли)).

Это связано с изменением ключей настроек (теперь их стало больше) в текущей версии аддона. В дальнейшем новые ключи меняться уже не будут (но указанный сброс в любом случае останется и в дальнейшем)).

Отказ от проверки/переноса сделан для упрощения кода и уменьшения его размера, преобразование единственной "старой" настройки в новую приведёт к неоправданным затратам (и ненужному увеличению размера кода) на такую проверку. Кроме того, при обновлении любой MV2‑версии на версию с манифестом MV3 ключ локального хранилища будет утрачен в любом случае.

…короче, не парьтесь и просто проверьте/переключите эту настройку ещё раз после обновления версии… :).

Кроме того, будет также сброшена привязка комбинации горячей клавиши.

Это связано с изменением "маркера" горячей клавиши. В дальнейшем этот ключ меняться не будет.

…в общем, просто проверьте/переопределите хоткей ещё раз после обновления версии…

Известные проблемы и ограничения: Для начала простой совет: по возможности используйте версию .URL+ с манифестом MV2, независимо от версии вашего браузера. В этом случае у расширения в принципе нет никаких эксплуатационных проблем, все функции и настройки полностью доступны и работают без каких‑либо ограничений (…и дальше можно не читать)).В браузерах версий CR88+ при установке версии с манифестом MV3 будьте готовы к тому, что:

Независимо от версии вашего браузера будут заблокированы отдельные пункты меню настроек.

Это сделано специально, блокируются (недоступны для изменения пользователем, но работают с установкой параметров по умолчанию) те опции настроек, которые в MV3 нельзя менять в силу ряда ограничений третьей версии манифеста. Что именно из настроек будет при этом заблокировано – смотрим на скриншотах ниже и сравниваем со скринами для MV2‑версий.

Проблема отсутствует при установке "классических" MV2‑версий, независимо от версии браузера и/или формата установочного пакета (CRX2 или CRX3). В этом случае будут доступны для изменения все настройки.

В зависимости от версии вашего браузера может быть выдано предупреждение об ограничении числа загружаемых файлов, если вы сохраняете несколько ярлыков подряд для одной страницы или сайта.

Не является ошибкой кода расширения и зависит только от применяемой версии манифеста установочного пакета. Связано с различиями доступных API для создания файла ярлыка страницы, а также с повышенной "заботой о вашей безопасности", которая может меняться в зависимости от настроек и умолчаний для конкретной версии конкретного браузера.

В подобных случаях решение о (временном) снятии блокировок браузера принимается пользователем самостоятельно. Полное отключение (в настройках сайтов) этой проверки НЕ рекомендуется, это приводит к снижению общего уровня безопасности вашего браузера.

Проблема отсутствует при установке "классических" MV2‑версий, независимо от версии браузера и/или формата установочного пакета (CRX2 или CRX3). В этом случае вам будет доступно неограниченной число попыток создания ярлыков для любых сайтов и страниц.

В зависимости от "брэнда" вашего браузера будет невозможно создание ярлыков в магазине CWS (возможно – и в других репозиториях приложений тоже).

Не является ошибкой кода расширения и зависит только от применяемой версии манифеста установочного пакета. Связано с особенностями API для создания файла ярлыка страницы (и с известной "огороженностью" производителями браузеров своих "вебсторов")).

В подобных случаях никаких сообщений пользователю не выдаётся, диалог сохранения файла также не будет показан ("молчаливый отлуп", хоть занажимайся до синего)). При этом в консоли расширения появится запись "The extensions gallery cannot be scripted" (фиг тебе, проще говоря…:)).

Проблема отсутствует при установке "классических" MV2‑версий, независимо от версии браузера и/или формата установочного пакета (CRX2 или CRX3). В этом случае аддон сохраняет ярлыки любых страниц любых сайтов (ярлыки на локальные и служебные страницы также сохраняются).

В браузерах версий CR132+ будет невозможно создание ярлыков на служебных страницах (chrome*://*).

Не является ошибкой кода расширения и зависит только от применяемой версии манифеста установочного пакета. Связано с особенностями API для создания файла ярлыка страницы (и с повышной "бдительностью" этих версий по отношению к доступу к внутренним страницам).

В подобных случаях никаких сообщений пользователю не выдаётся, диалог сохранения файла также не будет показан ("молчаливый отлуп", хоть занажимайся до синего)). При этом в консоли расширения появится запись "Cannot access a chrome:// URL" (то бишь фигвам…:)).

Проблема отсутствует при установке "классических" MV2‑версий, независимо от версии браузера и/или формата установочного пакета (CRX2 или CRX3). В этом случае аддон нормально сохраняет ярлыки любых локальных и служебных страниц.

Обновлено 29.04.2025:Все указанные выше ограничения сняты в версии .URL+ RU : UniMax : 2025.4.28: теперь, независимо от версии вашего браузера и выбранного типа установщика, все функции и настройки полностью доступны и работают на любых страницах.В связи с этим настоятельно рекомендуется обновить версию до текущей актуальной (в любом случае).Скриншоты:Блок .URL+ на странице со списком расширений:
Пункт контекстного меню текущей страницы для создания ярлыка на неё:
Настройки и ссылки на документацию (кнопка на тулбаре, CR48+):
Настройки и ссылки на документацию (кнопка в омнибоксе, CR48+):
Настройки и ссылки на документацию (меню на служебной странице, CR31–CR47):
Меню настроек в CR31–CR47 при отключении пункта сохранения ярлыка:
Заблокированные пункты меню настроек при установке MV3‑варианта:
История и обсуждение

Ru-Board: Анонс этой версии на форуме (с последующим обсуждением)

var container = document.getElementById('nativeroll_video_cont'); if (container) { var parent = container.parentElement; if (parent) { const wrapper = document.createElement('div'); wrapper.classList.add('js-teasers-wrapper'); parent.insertBefore(wrapper, container.nextSibling); } }

Общие технические сведения

Технологии и API:
Чистый JavaScript (ES5), API: content-script, tabs, contextMenus, pageAction, commands, declarativeContent, action, storage, scripting
Запрашиваемые разрешения:
общие: [ "activeTab", "tabs", "contextMenus", "declarativeContent", "all_urls", "storage", "scripting"], инжектор: ["file://*.url"]