Tovább a tartalomhoz

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 okozta hibák azonosítását és javítását mutatja be. Tapasztalt felhasználóknak és fejlesztőknek szól.

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.

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.

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

  • 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.

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

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.

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

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.

  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.

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.

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ó.

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.

/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ő 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.

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

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

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

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:

<script data-nowprocket src="https://yourdomain.com/wp-content/themes/script.js"></script>
<script data-nowprocket>
function myFunction() {
// Some code
}
</script>
<script>
// nowprocket
function myFunction() {
// Some code
}
</script>

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

Szekció neve “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ü

Szekció neve “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.

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:

<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

Szekció neve “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.

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások