← Wszystkie wpisy

Przewodniki

Migracja z Tampermonkey lub Greasemonkey do JustZix

17 maja 2026 · autor JustZix Team

Jeśli żyłeś z Tampermonkey lub Greasemonkey, rozumiesz już rdzeń pomysłu: uruchom własny kod na cudzej stronie. JustZix zachowuje tę moc, ale przekształca ją wokół reguł dopasowanych do URL — małych, ograniczonych, indywidualnie przełączalnych jednostek CSS lub JS. Ten przewodnik mapuje model userscriptów na JustZix i pokazuje, gdzie każde narzędzie błyszczy.

Model myślowy: skrypty kontra reguły

Userscript to jeden plik z nagłówkiem metadanych. JustZix dzieli to samo zadanie na dwie rzeczy: dopasowanie URL (gdzie działa) i ładunek (CSS lub JS). Blok metadanych, który pisałeś, staje się polem w edytorze reguł.

• @match / @include → wzorzec URL reguły, np. *://*.youtube.com/*
• @run-at document-end → JustZix domyślnie uruchamia reguły JS po przygotowaniu DOM
• Stylizacja przez GM_addStyle → dedykowana reguła CSS, bez potrzeby JS
• Jeden duży skrypt → kilka małych reguł, które przełączasz niezależnie

Największa zmiana: w JustZix CSS jest pierwszoklasowy. Wszystko, co robiłeś z GM_addStyle, staje się czystą regułą CSS, która jest szybsza, bezpieczniejsza i łatwiejsza do czytania.

Przenoszenie userscriptu tylko z CSS

Sporo userscriptów istnieje wyłącznie po to, by wstrzyknąć arkusz stylów. Oto typowy:

// ==UserScript==
// @name    Ukryj YouTube Shorts
// @match   *://*.youtube.com/*
// ==/UserScript==
GM_addStyle(`
  ytd-reel-shelf-renderer { display: none !important; }
`);

W JustZix to zwija się do reguły CSS. Dopasowanie URL: *://*.youtube.com/*. Ładunek:

ytd-reel-shelf-renderer { display: none !important; }

To cała migracja. Żadnego opakowania, żadnego GM_addStyle, żadnego komentarza metadanych — edytor reguł trzyma dopasowanie za ciebie.

Przenoszenie userscriptu manipulującego DOM

Skrypty zmieniające stronę w czasie działania stają się regułami JS. Ciało skryptu zwykle przenosi się dosłownie; po prostu odrzucasz nagłówek metadanych. Userscript, który czeka na element:

// ==UserScript==
// @name    Auto-rozwin komentarze
// @match   *://example.com/*
// @run-at  document-end
// ==/UserScript==
(function () {
  const btn = document.querySelector('.show-comments');
  if (btn) btn.click();
})();

Staje się regułą JS JustZix z dopasowaniem *://example.com/* i ładunkiem:

const btn = document.querySelector('.show-comments');
if (btn) btn.click();

Dla aplikacji jednostronicowych ten sam wzorzec, którego używałeś w userscriptach, nadal obowiązuje — obserwuj DOM zamiast zakładać pojedyncze załadowanie:

function run() {
  const btn = document.querySelector('.show-comments');
  if (btn && !btn.dataset.done) {
    btn.dataset.done = '1';
    btn.click();
  }
}
run();
new MutationObserver(run).observe(document.body, {
  childList: true, subtree: true
});

Co nie przenosi się bezpośrednio

JustZix uruchamia twój JS w kontekście strony ze standardowymi API sieciowymi. Dodatki menedżera userscriptów wymagają przemyślenia:

• GM_setValue / GM_getValue → użyj localStorage do trwałości per strona
• GM_xmlhttpRequest (fetch z innego pochodzenia) → nie jest celem JustZix; trzymaj te skrypty w menedżerze userscriptów
• @require zewnętrzne biblioteki → wbuduj, czego potrzebujesz, lub wklej bibliotekę do reguły
• GM_registerMenuCommand → zbuduj własny przycisk na stronie

To uczciwa linia podziału poniżej.

Kiedy użyć którego

JustZix lepiej pasuje, gdy twoim celem jest poprawianie, jak strony wyglądają i się zachowują: ukrywanie bałaganu, restylizacja, małe skróty UX, ograniczona automatyzacja. Model reguł trzyma każdą poprawkę odizolowaną, łatwą do przełączania i trywialną do udostępnienia jako zwykły CSS lub JS.

Zachowaj menedżer userscriptów, gdy skrypt potrzebuje dostępu sieciowego z innego pochodzenia, ciężkiej biblioteki strony trzeciej lub magazynu wartości przeżywającego wiele stron. Oba narzędzia dobrze współistnieją — wielu użytkowników uruchamia JustZix do dziesiątek małych poprawek wizualnych, a swój menedżer userscriptów rezerwuje dla dwóch czy trzech ciężkich skryptów.

Lista kontrolna migracji

• Wypisz swoje userscripty i oznacz każdy: tylko CSS, poprawka DOM lub intensywny sieciowo.
• Przenieś każdy skrypt tylko z CSS do reguły CSS JustZix — zwykle to kopiuj-wklej bloku stylów.
• Przenieś poprawki DOM do reguł JS; usuń nagłówek metadanych, zachowaj ciało.
• Podziel duże wielozadaniowe skrypty na kilka małych reguł, byś mógł przełączać funkcje.
• Zostaw intensywne sieciowo skrypty tam, gdzie są.

Nagrodą jest klarowność: zamiast jednego nieprzejrzystego pliku skryptu otrzymujesz schludną listę nazwanych reguł, każda ograniczona dokładnie do jednej strony. Zacznij od naszych gotowych przykładów, aby zobaczyć format reguł w akcji, lub przeskocz do konkretnego poradnika, jak poprawki GitHuba dla programistów. Pobierz JustZix i przenieś swój pierwszy arkusz stylów już dziś.