пятница, 16 марта 2012 г.

Scriptish. Ключи исполнения

Итак переходим к ключам метаданных, которые отвечают за настройку исполнения пользовательского сценария
@include
Ключ включения сценария. Лпределяет URL, при котором сценарий будет включен в поток скриптов и исполнен. Допускается многократное использование ключа, для каждого URL.
// @include http://www.example.com/*
// @include http://*
// @include *
знак (*) - означает любое сочетание буквоцифр. Также можно использовать для выделения включения допустимое регулярное выражение (только для Scriptish**) и только с флагом i
// @include /^https?:\/\/(?:www\.)?google\.com\/something\//i
@match
то же включатель, но для браузеров системы Google Chromic's. Принцип такой же как и у @include
@exclude
Выключатель. Принцип селекции URL такой же как и у @include, но имет более высокий приоритет по сравнению с ним, таким образом ссужая диапазон страниц открытых для исполнения включателем. Так же можно использовать многократно, для селекции нескольких URL
@domain**
Ключи определяет перечень доменов, к которым разрешен доступ по технологии AJAX и теп самым определяют кроссдоменость работу скрипта. Если ключ не указан, то открыт зеленый коридор для все-вохможных доменов сети. Смотри рекомендации по CORS
@run-at**
Фаза исполнения. Идея взята из Google Chromic's и определяет фазу исполнения юзеровского скрипта. На сегодня параметром этого ключа может быть один из вариантов
  • document-start: запуск осуществляется на начале загрузки контента
  • document-end: запуск выполняется после исполнения прерывания DOMContentLoaded, т.е в момент загрузки DOM-контента
  • document-idle: запуск на промежутке между загрузкой DOM и window, в так называемой зоне спокойствия
  • window-load: в момент исполнения события window.onload()
Если ключ запуска не указан, то для Scriptidh, как и для GreazeMonkey подразумевапется document-end, а для Google Chromic's - document-idle
@priority**
Приоритет исполнения скрипта. Используется когда несколько скриптов имеют одинаковый @run-at. По умолчанию значение приоритета равно 0. Бплее высокий приоритет у положительных значений, более низкий у отрицательных.
@delay**
Задержка в милисекундах перед исполнением скрипта
@resource
Oпределяет URL - ресурсов которые необходимо загрузить и сохранить на диске перед первым исполнением скрипта, а так же при его обновлении. В качестве ресурса может выступать любой файл, ер в оснавном это изображения. Формат ресурса имеет следующий вид
// @resource идентификатор_ресурса ссылка_к_его_расположению
@require
сторонние скрипты которые необходимо заерузить для полнокровной работы пользовательского скрипта. В качестве их иогут выступать библиотеки скриптов и прочее
@jsversion**
версия javascripts библиотеки браузера
@noframes**
Значения не имеет, но явно дает понять браузеру, что исполнение пользовательского скрипта не должно распространятся во фрэймах