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.
Első lépések
Szekció neve “Első lépések”Először győződj meg arról, hogy tényleg a késleltetés a hibás funkció:
- 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.
- 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
Szekció neve “Hibatípusok”Csak esztétikai hibák
Szekció neve “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
Szekció neve “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
Szekció neve “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_ERRORPHP-hibát okoz, ilyenkor a WP Rocket nem alkalmazza a késleltetést az oldalra. Megoldás lehet awp-config.phpfájlba írtini_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
Szekció neve “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
Szekció neve “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ő
Szekció neve “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
Szekció neve “Á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
Szekció neve “A konzol ellenőrzése”- Nyisd meg azt a webcímet, ahol a hibát látod.
- 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 aexample_codefüggvényre vagy változóra szükség lett volna, de nem volt elérhető, mert a definíciója késleltetve van. - Nyiss egy másik lapot ugyanazzal a webcímmel, a végére
?nowprocketfűzve, így a WP Rocket optimalizálásai nélkül töltődik be. - 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.
- Írd a keresőbe az
example_codenevet: kilistázza az összes szkriptet, amely használja vagy definiálja. - 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
Szekció neve “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.
- Nyisd meg a hibás webcímet.
- Azonosítsd az érintett elemet (például a mobil hamburger menüt).
- Keresd meg az elem HTML-jét a böngésző elemvizsgálójával.
- Azonosítsd az elemhez tartozó osztályt.
- Nyiss egy másik lapot ugyanazzal a webcímmel
?nowprocket-tel. - A Keresés fülön keresd meg a kapcsolódó szkripteket.
- Í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
Szekció neve “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
Szekció neve “Kizárások”Biztonságos mód
Szekció neve “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
Szekció neve “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
Szekció neve “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
Szekció neve “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
Szekció neve “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
Szekció neve “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:
<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>Példák
Szekció neve “Példák”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.
- Nyisd meg a hibás webcímet.
- A konzolban látod a hibákat: itt a
woof_current_valuesés awoof_autosubmitaz érintett függvény. - Nyiss egy másik lapot
?nowprocket-tel. - Ott a konzolban nyisd meg a Keresés fület.
- Keresd a
woof_current_valuesnevet: kilistázza a fájlokat. Ugyanez a lista jön awoof_autosubmitkeresésekor is. - Írd a fájlokat a kizárási mezőbe, mentsd, és ellenőrizd.
- A szűrés még mindig hibás, a konzolban új hiba jelent meg.
- 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.
- 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/(.*) - 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.
- Nyisd meg a hibás webcímet.
- Azonosítsd a menüelemet az oldal jobb felső sarkában.
- Az elemvizsgálóval keresd meg a menü HTML-jét.
- Azonosítsd az osztályt: itt
burger. - Nyiss másik lapot
?nowprocket-tel. - A Keresés fülön keresd a
burgerosztályhoz tartozó szkripteket. - Add a
/themes/V4/assets/js/scripts.min.jsszkriptet a kizárásokhoz, mentsd, és ellenőrizd.
Alappéldák
Szekció neve “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:
- A kizárás kulcsszavakat is felismer, ezért elég:
/wp-content/plugins/gravityforms/js/ - 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: