Методические указания. Юзерскрипт — это текстовый файл с расширением user.js

Юзерскрипт — это текстовый файл с расширением user.js. В начале файла располагается блок метаданных — описание самого скрипта. После блока метаданных следует javascript-код, который и будет исполняться браузером.

Рассмотрим тестовый скрипт, который показывает alert с текстом на определенной странице.

код

// ==UserScript==

// @name myUserJS

// @description Мой самый первый юзерскрипт

// @author Vasya Pupkin

// @license MIT

// @version 1.0

// @include http://userscripts.org/*

// ==/UserScript==

// [1] Оборачиваем скрипт в замыкание, для кроссбраузерности (opera, ie)

(function (window, undefined) { // [2] нормализуем window

var w;

if (typeof unsafeWindow!= undefined) {

w = unsafeWindow

} else {

w = window;

}

// В юзерскрипты можно вставлять практически любые javascript-библиотеки.

// Код библиотеки копируется прямо в юзерскрипт.

// При подключении библиотеки нужно передать w в качестве параметра окна window

// Пример: подключение jquery.min.js

// (function(a,b){function ci(a)... a.jQuery=a.$=d})(w);

// [3] не запускаем скрипт во фреймах

// без этого условия скрипт будет запускаться несколько раз на странице с фреймами

if (w.self!= w.top) {

return;

}

// [4] дополнительная проверка наряду с @include

if (/http:\/\/userscripts.org/.test(w.location.href)) {

//Ниже идёт непосредственно код скрипта

alert("Userscripts приветствует вас навязчивым окном.");

}

})(window);

код

В самом начале располагается блок метаданных (в виде комментария).

код

// ==UserScript==

//...

// ==/UserScript==

код

Этот блок состоит из директив описания юзерскрипта. Ниже в таблице представлены основные директивы и их назначение.

При отсутствии директив @ include или @ match, юзерскрипты будут запускаться на всех страницах.

Вы можете скопировать код юзерскрипта в файл, назвать его my.user.js, и закинуть полученный файл в браузер (используйте Chrome или Firefox с установленным GreaseMonkey).

Рецепт для написания ~70% скриптов:

1. Придумываем, что будет делать наш юзерскрипт (перекрашивать ссылки, например)

2. Берём шаблон из теоретической части

3. Сохраняем в файл my.user.js

4. Удаляем строку с alert(...).

5. Идём на форум (userscripts.org или любой форум по javascript).

6. Изменяем метаданные и проверку url страницы на нужные нам.

7. Вставляем полученный код в юзерскрипт.

8. Сохраняем файл.

...

Готово!