# A JavaScript-késleltetés hibaelhárítása

> A késleltetés okozta hibák felismerése és megoldása: konzol- és kontextustechnika, kizárási minták, gyakori esetek.

Ez a haladó szintű fejezet a [JavaScript végrehajtásának késleltetése](https://hub.hellowp.io/hu/plugins/wp-rocket/fajloptimalizalas-javascript-vegrehajtas-kesleltetese/) okozta hibák azonosítását és javítását mutatja be. Tapasztalt felhasználóknak és fejlesztőknek szól.

## Első lépések

Először győződj meg arról, hogy tényleg a késleltetés a hibás funkció:

1. A hiba csak akkor jelentkezzen, ha a késleltetés be van kapcsolva, és a **JavaScript és CSS** oldal többi funkciója ki van kapcsolva.
2. Kapcsold ki a késleltetést: ha a hiba megszűnik, ez a hibás funkció.

Érdemes a böngésző Fejlesztői eszközök → Konzol részében a már meglévő hibákat is kijavítani, mert zavarhatják a hibakeresést.

Ezután döntsd el, hogy a hiba csak esztétikai, vagy a működést érinti.

## Hibatípusok

### Csak esztétikai hibák

A késleltetéssel egyes elemek csak később vagy interakció után jelennek meg. Ha ez nem zavarja a működést, esztétikai hibáról van szó. Két irány közül választhatsz:

- **Felhasználói élmény:** megkeresed és kizárod a késleltetésből az érintett szkripteket. A teljesítmény romlik.
- **Teljesítmény:** nem zárod ki a fájlokat. A látogatóknak várniuk kell, vagy interakciót kell végezniük, mielőtt az elem megjelenik.

### Elrendezési vagy működési hibák

Ha egy elem a várakozás vagy interakció után sem működik, zárd ki az érintett fájlokat.

### Gyakori esetek

- **Képek lusta betöltése:** egyes sablonok és bővítmények saját lusta betöltést használnak, és a késleltetéssel a képek nem jelennek meg, vagy csak interakció után. Kapcsold ki a sablon vagy bővítmény lusta betöltését, és használd a WP Rocket LazyLoad funkcióját. A Smush és az EWWW lusta betöltését a WP Rocket automatikusan kizárja, ezért azt nem kell kikapcsolnod.
- **Előtöltők (preloader):** a tartalmat elrejtő, forgó ikonos előtöltők a késleltetéssel interakcióig pörögnek. Kapcsold ki a sablon előtöltőjét. Így a látogató hamarabb látja a tartalmat.
- **A PageSpeed hibát jelez pontszám helyett:** ha az oldal tartalma JavaScript nélkül nem jelenik meg (például előtöltő miatt), a PageSpeed hibát adhat.
- **A késleltetés egyes oldalakon nem működik:** ritkán egy HTML-kód feldolgozása `PREG_BACKTRACK_LIMIT_ERROR` PHP-hibát okoz, ilyenkor a WP Rocket nem alkalmazza a késleltetést az oldalra. Megoldás lehet a `wp-config.php` fájlba írt `ini_set('pcre.backtrack_limit', 99999999);` sor, vagy kérd meg a tárhelyszolgáltatódat, hogy emelje meg az értéket.
- **New Relic Real User Monitoring:** az általa hozzáadott JavaScript zavarhatja a késleltetést, és csak az összes szkript kizárásával működnének az elemek. Az egyetlen megoldás a New Relic kikapcsolása. Ellenőrzéshez keresd a forráskódban ezt: `<script type="text/javascript">(window.NREUM||(NREUM={}))`
- **Hiba egy korábbi WP Rocket-frissítés után:** a késleltető szkript egy korábbi frissítésben megváltozott, és olyan elrendezési hibákat okozott, amelyeket kizárással nem lehetett javítani. A legtöbbet későbbi frissítések javították. A maradék hibákhoz a „WP Rocket | Change Delay JS Execution Script” segédbővítmény visszaállítja a késleltető szkript utolsó jól működő változatát.

## Technikák a megoldáshoz

Néha ugyanazt a technikát többször kell alkalmazni, vagy kombinálni kell őket.

### Egykattintásos kizárások

A **JavaScript végrehajtásának késleltetése** alatt, az **Egykattintásos kizárások** blokkban jelöld be az érintett bővítményt, sablont vagy szolgáltatást.

### A Kizárt JavaScript-fájlok mező

Ha nincs ott az egykattintásos kizárás, a szkripteket kézzel is beírhatod a **Kizárt JavaScript-fájlok** mezőbe.

### Általános függőségek kizárásai

Ha az oldalon általános függőségekkel (például jQuery) kapcsolatos JavaScript-hibák vannak, használd a lent ismertetett, jQuery-re vonatkozó páros kizárást.

### A konzol ellenőrzése

1. Nyisd meg azt a webcímet, ahol a hibát látod.
2. Nyisd meg a böngésző Fejlesztői eszközök → Konzol részét, és keresd a JavaScript-hibákat. A hiba megnevezi a problémás szkriptet. Gyakori hibák: `Uncaught ReferenceError: example_code is not defined` és `... is not a function`. Ez azt jelenti, hogy a `example_code` függvényre vagy változóra szükség lett volna, de nem volt elérhető, mert a definíciója késleltetve van.
3. Nyiss egy másik lapot ugyanazzal a webcímmel, a végére `?nowprocket` fűzve, így a WP Rocket optimalizálásai nélkül töltődik be.
4. Ebben a lapban is nyisd meg a konzolt, és a Keresés (Search) fület, amely az összes betöltött erőforrásban keres. Chrome-ban a jobb oldali három pontnál találod.
5. Írd a keresőbe az `example_code` nevet: kilistázza az összes szkriptet, amely használja vagy definiálja.
6. A listázott fájlokat írd a késleltetés kizárási mezőjébe, mentsd, és nézd meg, megszűnt-e a hiba.

Finomíthatod a kizárásokat úgy, hogy egyenként kiveszed a fájlokat, és ellenőrzöd, nem tér-e vissza a hiba. Néha más fájlok függnek a kizártaktól, és új konzolhibák jelennek meg: ilyenkor ismételd meg a technikát.

### Keresés kontextus alapján

A kontextustechnikával az érintett funkcióhoz tartozó szkripteket keresed. Gyakran az elem osztálya árulkodik: a JavaScript általában ezzel az osztállyal működik.

1. Nyisd meg a hibás webcímet.
2. Azonosítsd az érintett elemet (például a mobil hamburger menüt).
3. Keresd meg az elem HTML-jét a böngésző elemvizsgálójával.
4. Azonosítsd az elemhez tartozó osztályt.
5. Nyiss egy másik lapot ugyanazzal a webcímmel `?nowprocket`-tel.
6. A Keresés fülön keresd meg a kapcsolódó szkripteket.
7. Írd az összes szkriptet a késleltetés kizárási mezőjébe, mentsd, és ellenőrizd, megszűnt-e a hiba.

Itt is finomíthatod a találatokat az egyenkénti kivétellel.

### Kizárásos módszer

A kizárandó fájlokat az eliminációs módszerrel is megtalálhatod: egyenként kizárod, illetve visszateszed a fájlokat, és figyeled a hibát. A CSS-minifikálás hibaelhárításánál leírt eljárás JavaScriptre is alkalmazható.

## Kizárások

### Biztonságos mód

A gyors megoldáshoz kapcsold be a **Biztonságos mód a JavaScript végrehajtásának késleltetéséhez** jelölőnégyzetet. Ez kizárja a `/wp-content/` és `/wp-includes/` mappák szkriptjeit, a jQuery és jQuery Migrate könyvtárakat, valamint a `wp_add_inline_script()` függvénnyel hozzáadott beágyazott szkripteket (`js-(before|after)`). A legtöbb szkript így nem késleltetett, a hibák eltűnnek, de a késleltetés teljesítményjavító hatása nagyrészt elvész. Ezért finomítsd a kizárásokat a fenti technikákkal. Nem ajánlott, utolsó megoldásnak tartogasd, ha a kizárások megtalálása túl bonyolult.

### Kizárási minták

```
/plugins/(.*)
/themes/(.*)
/wp-includes/(.*)
/uploads/(.*)
/cache/min/(.*)
\(
\{
```

A `/plugins/(.*)`, `/themes/(.*)`, `/wp-includes/(.*)`, `/uploads/(.*)` és `/cache/min/(.*)` az adott mappák összes szkriptjét kizárja. A `\(` és `\{` az összes beágyazott szkriptet kizárja.

Bizonyos minták nem kezelhetők, ezeket a WP Rocket automatikusan eltávolítja, és értesítést mutat: „WP Rocket: The following patterns are invalid and have been removed”.

### Külső szkriptek

Külső szkript kizárásához a fájlnevet, esetleg az útvonal egy részét használd, a külső tartományt kerüld. Ha a **JavaScript-fájlok minifikálása** be van kapcsolva, a szkript a saját szervereden tárolódik, a tartomány nem egyezne. Például az `ads.com/ads-folder/script.js` kizárásához írd: `/ads-folder/script.js`.

### Páros kizárások

A jQuery és jQuery Migrate fájlokat együtt zárd ki ezzel a sorral:

```
\/jquery(-migrate)?-?([0-9.]+)?(.min|.slim|.slim.min)?.js(\?(.*))?( |'|"|>)
```

### Oldalspecifikus kizárások

Ha egy szkriptet csak néhány webcímen akarsz kizárni, az erre szolgáló segédbővítményt használd.

### Kizárás attribútummal

A `nowprocket` kulcsszó kizárást vált ki, ha fájlnév, attribútumnév vagy -érték, illetve szkripttartalom része (például megjegyzésben). Programozottan például `data-nowprocket` attribútummal zárhatsz ki:

```html
<script data-nowprocket src="https://yourdomain.com/wp-content/themes/script.js"></script>
```

```html
<script data-nowprocket>
  function myFunction() {
    // Some code
  }
</script>
```

```html
<script>
  // nowprocket
  function myFunction() {
    // Some code
  }
</script>
```

## Példák

### A konzoltechnika példája: WOOF terméksűrő

A WOOF (WooCommerce Products Filter) bővítménynél a látogatók nem tudják szűrni a keresési találatokat, tehát a késleltetés a működést érinti.

1. Nyisd meg a hibás webcímet.
2. A konzolban látod a hibákat: itt a `woof_current_values` és a `woof_autosubmit` az érintett függvény.
3. Nyiss egy másik lapot `?nowprocket`-tel.
4. Ott a konzolban nyisd meg a Keresés fület.
5. Keresd a `woof_current_values` nevet: kilistázza a fájlokat. Ugyanez a lista jön a `woof_autosubmit` keresésekor is.
6. Írd a fájlokat a kizárási mezőbe, mentsd, és ellenőrizd.
7. A szűrés még mindig hibás, a konzolban új hiba jelent meg.
8. Ismételd az eljárást a jQuery függvényére. A jQuery fájlja páros kizárásban van a jQuery Migrate fájllal.
9. Mivel sok a WOOF-fájl, vond össze őket helyettesítő karakterrel, hogy ne legyen újabb hiba más WOOF-fájloknál: `/woocommerce-products-filter/(.*)`
10. A végső kizárások: `/jquery-?[0-9.](.*)(.min|.slim|.slim.min)?.js`, `/jquery-migrate(.min)?.js` és `/woocommerce-products-filter/(.*)`.

### A kontextustechnika példája: hamburger menü

A késleltetés megakadályozza, hogy a mobil hamburger menüre kattinthass.

1. Nyisd meg a hibás webcímet.
2. Azonosítsd a menüelemet az oldal jobb felső sarkában.
3. Az elemvizsgálóval keresd meg a menü HTML-jét.
4. Azonosítsd az osztályt: itt `burger`.
5. Nyiss másik lapot `?nowprocket`-tel.
6. A Keresés fülön keresd a `burger` osztályhoz tartozó szkripteket.
7. Add a `/themes/V4/assets/js/scripts.min.js` szkriptet a kizárásokhoz, mentsd, és ellenőrizd.

### Alappéldák

**Egy fájl kizárása.** A `/wp-content/plugins/gravityforms/js/gravityforms.min.js?ver=2.4.23` fájlhoz elég: `gravityforms/js/gravityforms.min.js`. A verziószám elhagyása ajánlott, így a fájl a változás után is kizárt marad.

**Több fájl kizárása.** A `/gravityforms/js/` alatti összes fájlhoz két mód van:

1. A kizárás kulcsszavakat is felismer, ezért elég: `/wp-content/plugins/gravityforms/js/`
2. Vagy helyettesítő karakterrel: `/wp-content/plugins/gravityforms/js/(.*).js`

**Beágyazott szkript kizárása.** Válassz a szkriptre egyedi szövegrészletet. Ennél a szkriptnél:

```html
<script type="text/javascript">
    (function () {
        var c = document.body.className;
        c = c.replace(/woocommerce-no-js/, 'woocommerce-js');
        document.body.className = c;
    })()
</script>
```

jó választás a `/woocommerce-no-js/`.

### Szélső esetek: Content Security Policy

Ha az oldal szigorú Content Security Policy-t (CSP) használ, a késleltetett szkriptek nem töltődhetnek be, és a konzolban ilyen hiba jelenik meg: „Refused to load the script 'data:text/javascript;base64,...' because it violates the following Content Security Policy directive”.

Az optimalizálás egyes beágyazott szkripteket `data:` kezdetű, base64 kódolású webcímmé alakít, amit egyes CSP-szabályok tiltanak. A CSP `script-src` beállításába vedd fel például:

```
Content-Security-Policy: script-src 'self' data: https://example.com;
```

Ez engedélyezi a saját tartományod szkriptjeit, a `data:` protokollt használókat és a további megbízható tartományokat. Ha ez sem segít, fordulj a tárhelyszolgáltatódhoz.
