# JavaScript

> JavaScript halasztása, késleltetése és minifikálása, kivételek kezelése és gyakori hibák.

A **JavaScript** fülön három szakasz van: **Halasztás**, **Késleltetés** és **Minifikálás**. Mindegyik a JavaScript betöltését gyorsítja, de másképp működik.

![A JavaScript fül beállításai](./kepek/javascript.webp)

*A JavaScript fül beállításai* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters)

A képen a három szakaszt láthatod egymás alatt. A **Haladó opciók mutatása** kapcsoló (**Eszközök** fül) bekapcsolása után további beállítások jelennek meg: **jQuery bevonása**, **Kattintáskésleltetés letiltása** és **FastClick engedélyezése**.

## Halasztás

A böngészők a JavaScriptet általában azonnal betöltik, ami lassítja az oldal első megjelenését (a mérőeszközök ezt „megjelenítést blokkoló erőforrások” figyelmeztetésként jelzik). A halasztás azt jelenti, hogy a szkript letöltődik, de csak az oldal feldolgozása után fut le. A bővítmény minden JavaScript-fájlra egy `defer` attribútumot tesz. A halasztott szkriptek a HTML-ben megjelenésük sorrendjében futnak. Ha egy szkriptnek már van `defer` attribútuma, nem kap másodikat.

1. Nyisd meg a **JavaScript** fület.
2. A **Halasztás** szakaszban kapcsold be a **JavaScript halasztása** kapcsolót.
3. Kattints a **Módosítások mentése** gombra.

| Beállítás | Mit csinál |
| --- | --- |
| **JavaScript halasztása** | A JavaScript-fájlokhoz hozzáadja a `defer` attribútumot. |
| **Inline szkriptek bevonása** | A beágyazott (inline) szkripteket is halasztja. Segíthet a „még nincs definiálva” konzolhibákon, amelyeket függőségek okoznak. A teljesítménye változó, mert az inline szkripteket kódolni kell. Kisebb, már jól optimalizált oldalon növelheti a teljes blokkolási időt, ezért előtte-utána mérd meg. |
| **jQuery bevonása** | Csak haladó opciókkal látszik. Lehetővé teszi, hogy a WordPress jQuery magja is halasztott legyen. Külön próbáld ki, vagy hagyd kikapcsolva, mert sok bővítmény és sablon igényli a jQuery azonnali betöltését. |
| **Kivétel a halasztás alól** | Azok a szkriptek, amelyeket nem szabad halasztani. Soronként egy fájlnév, például `script.js`. Ha az általános fájlnév több helyen is előfordul, adj hozzá útvonalrészt is, például `/generatepress/js/menu.min.js`. |

Gyakori kivételek a WordPress magjából: `hooks.min.js` és `i18n.min.js`. Cloudflare Turnstile vagy Fluent Forms Turnstile esetén a `turnstile` szöveget is vedd fel kivételnek.

Ha egyetlen oldalt vagy bejegyzést ki akarsz venni a halasztásból, a szerkesztő jobb oldali paneljén szedd ki a **Defer JavaScript** jelölőnégyzetet. A panelt csak adminisztrátorok látják. A WooCommerce kosár-, pénztár- és fiókoldalait a bővítmény magától kihagyja az optimalizálásból, ezért ott a panel nem jelenik meg.

Ha már egy másik bővítménnyel halasztod a JavaScriptet, nem kell kétszer megtenned: maradhatsz annál, vagy átválthatsz a Perfmattersre. Ha gyanítod, hogy a halasztás okoz hibát, ideiglenesen kapcsold ki a fenti opciókat, és próbáld újra.

A halasztás a „kritikus kérések láncolása” figyelmeztetést is megszünteti.

### Halasztás szűrővel

A halasztás működését PHP-szűrőkkel is szabályozhatod. A `perfmatters_defer_js` szűrő például csak az oldalakon kapcsolja ki a halasztást:

```php
add_filter('perfmatters_defer_js', function($defer) {
    if (is_singular('page')) {
        return false;
    }
    return $defer;
});
```

## Késleltetés

A késleltetés a halasztásnál erősebb: a szkript csak akkor töltődik be, amikor a látogató először mozgatja az egeret, görget, vagy letelik egy időzítő. Egy sebességmérő eszközben úgy tűnik, mintha ezek a szkriptek ott sem lennének. Nagy hatása van a legnagyobb tartalmas festésre (LCP), és segít a „Reduce unused JavaScript” figyelmeztetésen is. Különösen nehéz harmadik féltől származó szkripteknél hasznos: Google AdSense, Google Analytics, konverziókövető pixelek.

Működik `type='javascript'` típusú vagy típus nélküli szkriptcímkével.

1. Nyisd meg a **JavaScript** fület.
2. A **Késleltetés** szakaszban kapcsold be a **JavaScript késleltetése** kapcsolót.
3. Válaszd ki a **Késleltetés működése** értékét.
4. Kattints a **Módosítások mentése** gombra.

### Késleltetés működése

- **Csak a megadott szkriptek késleltetése (Alapértelmezett)**: a **Késleltetett szkriptek** mezőbe írd be soronként a késleltetni kívánt szkriptek forrás-URL-jét (például `example.js`). Beágyazott szkriptnél a szkript egy egyedi szövegrészét add meg.
- **Minden szkript késleltetése**: a bővítmény megpróbál minden JavaScriptet késleltetni, a beágyazottakat is. Ez a legagresszívebb mód. Ilyenkor a **Késleltetésből kizárva** mezőben kell megadnod, melyek ne késsenek. Ugyanazt a formátumot használja, mint a **Késleltetett szkriptek** mező: soronként egy forrás-URL vagy egy egyedi szövegrész.

![A JavaScript fül „Minden szkript késleltetése” móddal](./kepek/javascript-minden-szkript.webp)

*A JavaScript fül „Minden szkript késleltetése” móddal* (https://minta-bolt.hu/wp-admin/options-general.php?page=perfmatters)

A képen a **Késleltetés működése** menü átváltása után megjelenő **Gyors kizárások** és **Késleltetésből kizárva** beállításokat nézd meg.

### Gyors kizárások

„Minden szkript késleltetése” módban, ha bizonyos népszerű bővítmények vagy sablonok aktívak, a **Gyors kizárások** alatt kapcsolók jelennek meg hozzájuk (például a WooCommerce termékgalériájához). Ezek előre elkészített kivétellisták, amelyeket egyetlen kapcsolóval alkalmazhatsz. A lista folyamatosan bővül.

### Késleltetési időkorlát

A **Késleltetési időkorlát** kapcsolóval beállíthatod, hogy a késleltetett szkriptek 15 másodperc után akkor is betöltődjenek, ha nem történt felhasználói művelet. Alapból ki van kapcsolva. Hasznos lehet, ha:

- a követőkód pontosabb adatot ad (például ha egy oldalmegtekintéshez cél tartozik, de a látogató nem mozdul, a cél akkor is teljesüljön),
- a látogató háttérlapokon nyit meg oldalakat, és a hirdetéseknek mégis meg kell jelenniük.

A böngészők a háttérlapokon korlátozhatják az időzítőket, ezért a betöltés nem feltétlenül pontosan a megadott időpontban történik: legkésőbb akkor, amikor az időzítő lefut vagy a látogató visszatér a lapra.

Más időkorlátot a `perfmatters_delay_js_timeout` szűrővel adhatsz meg.

### Példák késleltetett szkriptekre

Ezeket a szövegrészeket a **Késleltetett szkriptek** mezőbe írhatod, soronként egyet.

| Szkript | Mezőbe írandó szöveg |
| --- | --- |
| Google Analytics | `ga( '`, `ga('`, `google-analytics.com/analytics.js` |
| Helyi Perfmatters analytics (analytics.js) | `analytics.js` |
| Helyi Perfmatters gtag (v4) | `gtagv4.js` |
| Helyi Perfmatters minimális analitika | `analytics-minimal.js` |
| Google Tag Manager | `/gtm.js`, `/gtag/js`, `gtag(`, `/gtm-`, `/gtm.` |
| Google AdSense | `adsbygoogle.js` (Ad Inserterrel együtt még: `ai_insert_code`) |
| Facebook Pixel | `fbevents.js`, `fbq(`, `/busting/facebook-tracking/` |

### Beágyazott szkript késleltetése

Beágyazott szkript késleltetéséhez írd be a `<script>` címkén belüli szöveg egy egyedi részletét. Ha például a szkript tartalmaz egy `lazyLoadInstance` nevű változót, elég ezt a szót beírni. Fontos, hogy a megadott szöveg egyedi legyen. Ha egy szkriptnek külső fájlja és beágyazott része is van, mindkettőt késleltetni kell, különben nem működik.

### Gyakori kivételek „minden szkript” módban

Nagyobb oldalakon, főleg oldalépítővel, általában szükség lesz néhány kivételre. Néhány gyakori példa, amelyeket a kivételek mezőbe írhatsz:

| Terület | Kivételek |
| --- | --- |
| Elementor | `jquery.min.js`, `jquery.smartmenus.min.js`, `jquery.sticky.min.js`, `webpack.runtime.min.js`, `webpack-pro.runtime.min.js`, `/elementor/assets/js/frontend.min.js`, `/elementor-pro/assets/js/frontend.min.js`, `frontend-modules.min.js`, `elements-handlers.min.js`, `elementorFrontendConfig`, `ElementorProFrontendConfig`, `imagesloaded.min.js`, `hooks.min.js`, `i18n.min.js` |
| Divi | `jquery.min.js`, `/Divi/js/scripts.min.js`, `et_pb_custom`, `elm.style.display` |
| WooCommerce termékgaléria | `jquery.min.js`, `flexslider`, `single-product.min.js`, `slick`, `functions.min.js`, `waypoint` |
| Ninja Forms | `/wp-includes/js/underscore.min.js`, `/wp-includes/js/backbone.min.js`, `/ninja-forms/assets/js/min/front-end-deps.js`, `/ninja-forms/assets/js/min/front-end.js`, `nfForms`, `nf-`, `jquery.min.js` |
| Revolution Slider | `jquery.min.js`, `jquery-migrate.min.js`, `revslider`, `rev_slider`, `setREVStartSize`, `window.RS_MODULES` |
| Smart Slider | `/smart-slider-3/`, `_N2` |
| Adobe Fonts (Typekit) | `//use.typekit.net/` |
| GeneratePress mobilmenü | `/generatepress/assets/js/menu.min.js`, `generatepressMenu` |
| OceanWP mobilmenü | `drop-down-mobile-menu.min.js`, `oceanwpLocalize` |
| Oxygen Builder | `jquery.min.js`, `aos.js`, `oxygen-aos-enabled` |
| WPBakery | `/wp-content/plugins/js_composer/assets/js/dist/js_composer_front.min.js`, `jquery.min.js` |
| Gravity Forms | `/wp-includes/js/jquery/jquery.min.js`, `recaptcha`, `/gravityforms/`, `gform`, `/wp-includes/js/plupload/plupload.min.js`, `/wp-includes/js/plupload/moxie.min.js`, `/wp-includes/js/jquery/jquery-migrate.min.js`, `/gravityforms/js/conditional_logic.min.js`, `jquery-ui-datepicker-js`, `jquery-ui-datepicker-js-after` |
| Astra mobilmenü | `jquery.min.js`, `astra` |
| Atarim | `/atarim-client-interface/`, `jQuery_WPF`, `upgrade_url`, `jquery.min.js` |
| Avada sticky fejléc | `avada-header.js`, `modernizr.js`, `jquery.easing.js`, `avadaHeaderVars` |
| Blocksy mobilmenü | `ct-scripts-js` (a **Kattintáskésleltetés letiltása** opciót is kapcsold be) |
| Borlabs Cookie | `/wp-content/plugins/borlabs-cookie/`, `borlabs-cookie`, `BorlabsCookie`, `jquery.min.js` |
| Bricks csúszka | `/wp-content/themes/bricks/assets/js/libs/swiper.min.js`, `/themes/bricks/assets/js/libs/splide.min.js`, `/wp-content/themes/bricks/assets/js/bricks.min.js`, `bricks-scripts-js-extra` |
| Calculated Fields Form | `jquery.min.js`, `/wp-content/plugins/calculated-fields-form/`, `cp_calculatedfields` |
| Cloudflare Turnstile | `/wp-content/plugins/themer-pro/lib/js/fe-dev-tools.js`, `groovy` (a `turnstile` szöveget a halasztásból is zárd ki) |
| Complianz | `complianz` |
| Cookiebot | `consent.cookiebot.com` |
| Cookie Law Info | `/wp-content/plugins/cookie-law-info/legacy/public/js/cookie-law-info-public.js`, `cookie-law-info-js-extra`, `jquery.min.js` |
| Cookie Notice | `/wp-content/plugins/cookie-notice/js/front.min.js`, `cnArgs` |
| DebugHawk | `debughawk`, `window.DebugHawk` |
| Divi animációkkal | `jquery.min.js`, `jquery-migrate.min.js`, `.dipi_preloader_wrapper_outer`, `/Divi/js/scripts.min.js`, `/Divi/js/custom.unified.js`, `/js/magnific-popup.js`, `et_pb_custom`, `et_animation_data`, `var DIVI`, `elm.style.display`, `easypiechart.js` |
| Elementor keresés | `webpack-pro.runtime.min.js`, `webpack.runtime.min.js`, `elements-handlers.min.js`, `jquery.smartmenus.min.js` |
| Elementor tartalomjegyzék-widget (az Elementor fenti kivételeivel együtt) | `/wp-includes/js/dist/hooks.min.js`, `/wp-includes/js/dist/i18n.min.js`, `/wp-content/plugins/elementor/assets/lib/waypoints/waypoints.min.js` |
| Fluent Forms Cloudflare Turnstile-lal | `/wp-content/plugins/fluentform/`, `fluentForm`, `turnstile` (a `turnstile` szöveget a halasztásból is zárd ki) |
| GeneratePress masonry blog | `generateBlog`, `scripts.min.js`, `masonry.min.js`, `imagesloaded.min.js` |
| GeneratePress mobil előugró menü | `/generatepress/assets/js/menu.min.js`, `generatepressMenu`, `offside.min.js`, `offSide` |
| GDPR Cookie Compliance | `/wp-content/plugins/gdpr-cookie-compliance/`, `moove_gdpr`, `jquery.min.js` |
| JetMenu | `jquery.min.js`, `jquery-migrate.min.js`, `/elementor-pro/`, `/elementor/`, `/jet-blog/assets/js/lib/slick/slick.min.js`, `/jet-elements/`, `/jet-menu/`, `elementorFrontendConfig`, `ElementorProFrontendConfig`, `hasJetBlogPlaylist`, `JetEngineSettings`, `jetMenuPublicSettings` |
| Kadence Blocks Pro AOS (görgetésre animálás) | `/wp-content/plugins/kadence-blocks-pro/includes/assets/js/aos.min.js`, `kadence_aos_params` |
| Lightweight Cookie Notice | `/wp-content/lightweight-cookie-notice-free/public/assets/js/production/general.js`, `daextlwcnf-general-js-after`, `daextlwcnf-general-js-extra`, `cookieNotice` |
| Lottie-animációk | `jquery.min.js`, `jquery-migrate.min.js`, `window.scopes_array`, `lottie.min.js` |
| Mediavine | `mediavine` |
| Motion.page | `/motionpage/`, `MOTIONPAGE`, `gsap`, `body{visibility:inherit;}`, `body.style.visibility` |
| Newspaper | `jquery.min.js`, `jquery-migrate.min.js`, `tagdiv_theme.min.js`, `tdBlocksArray` |
| Presto Player | `/presto-player/dist/components/web-components/web-components.esm.js`, `/presto-player/src/player/player-static.js`, `var player`, `/wp-includes/js/dist/vendor/regenerator-runtime.min.js`, `/wp-includes/js/dist/api-fetch.min.js`, `/wp-includes/js/dist/hooks.min.js`, `/wp-includes/js/dist/i18n.min.js` |
| Raptive (korábban AdThrive) | `adthrive`, `ads.min.js`, `adthrive.min.js` |
| Real Cookie Banner | `/wp-content/plugins/vendor-banner.pro.js`, `/wp-content/plugins/banner.pro.js`, `realCookieBanner`, `real-cookie-banner-pro-banner-js-before` |
| Sahifa | `/themes/`, `tie-scripts`, `jquery.min.js` |
| Salient | `jquery.min.js`, `jquery-migrate.min.js`, `/salient/`, `/salient-nectar-slider/js/nectar-slider.js` |
| ShortPixel Adaptive Images | `shortpixel.ai/assets/js/bundles/spai-lib` |
| Slider Pro | `/wp-content/plugins/sliderpro/public/assets/js/jquery.sliderPro.min.js`, `SliderPro` |
| Smart Slider Pro | `/nextend-smart-slider3-pro/`, `_N2` |
| SureCart | `jquery.min.js`, `surecart`, `hooks.min.js`, `i18n.min.js`, `url.min.js`, `api-fetch.min.js`, `a11y.min.js`, `dom-ready.min.js` |
| Termageddon + Usercentrics | `jquery.min.js`, `termageddon`, `usercentrics`, `UC_UI` |
| WP Armour (ingyenes) | `wpa` |
| WP Armour extended | `wpae` |
| wpDiscuz | `/wp-content/plugins/wpdiscuz/`, `wpdiscuzAjaxObj`, `wpdiscuzEditorOptions`, `wpdiscuzUCObj`, `jquery.min.js` |
| WP Grid Builder | `wpgb` |
| WS Form | `jquery.min.js`, `jquery/ui`, `ws-form`, `wsf-wp-footer`, `quicktags-js-extra` |

Ha sok oldalépítős kivételre van szükséged, az Elementor kivétellistájához hasonlóan érdemes a **Gyors kizárások** kapcsolóit használni, ha az adott bővítményhez van.

### Késleltetés szűrővel

- A `perfmatters_delayed_scripts` szűrővel módosíthatod a késleltetett szkriptek listáját. Például asztali eszközön kiveheted a listából az egyik szkriptet:

```php
add_filter('perfmatters_delayed_scripts', function($scripts) {
    if (($key = array_search('name_of_your_script', $scripts)) !== false) {
        if (!wp_is_mobile()) {
            unset($scripts[$key]);
        }
    }
    return $scripts;
});
```

- A `perfmatters_delay_js` szűrővel a késleltetést egészében ki- vagy bekapcsolhatod. Például csak az oldalakon kapcsolhatod ki:

```php
add_filter('perfmatters_delay_js', function($delay) {
    if (is_singular('page')) {
        return false;
    }
    return $delay;
});
```

- A `perfmatters_inline_scripts` szűrővel a késleltetésből kizárt JavaScriptet beágyazhatod az oldalba. Csak kicsi fájlokra használd, mert a nagyobb HTML-oldal rontja az LCP-t.

### Egy oldal kivétele a késleltetésből

Ha egyetlen oldalt vagy bejegyzést ki akarsz venni a késleltetésből, a szerkesztő jobb oldali paneljén szedd ki a **Delay JavaScript** jelölőnégyzetet. A panel csak adminisztrátoroknak látszik. A WooCommerce kosár-, pénztár- és fiókoldalait a bővítmény magától kihagyja az optimalizálásból.

### Kattintáskésleltetés letiltása

Haladó opció. Nagy és összetett oldalon a kattintás (például a mobilmenü megnyitása) várhat, amíg minden szkript betöltődik. A **Kattintáskésleltetés letiltása** kapcsoló megakadályozza, hogy az első kattintás a JavaScript betöltéséig késsen. Ez az interakció késleltetését javítja. Csak akkor használd, ha már megfelelő kivételeket adtál meg.

1. Kapcsold be a **Haladó opciók mutatása** kapcsolót az **Eszközök** fülön.
2. A **JavaScript** fülön kapcsold be a **Kattintáskésleltetés letiltása** kapcsolót.
3. Kattints a **Módosítások mentése** gombra.

### FastClick

A **FastClick engedélyezése** haladó opció egy iOS-es hibát kerül meg, amely miatt a hivatkozások csak a második kattintásra működtek. A kapcsoló a FastClick könyvtárat tölti be az oldalad vagy a CDN-ed felől. A mai mobilböngészők többsége már nem érintett, és a FastClick problémát is okozhat, ezért csak különleges esetben kapcsold be.

### Késleltetés és halasztás együtt

A halasztás a szkriptet az oldal betöltésének végére tolja, de a szkript ettől még betöltődik, és számít a mérőszámokban. A késleltetés kiveszi a szkriptet az oldalbetöltésből, és csak felhasználói művelet után tölti be. Mindkettőt használhatod együtt: ha egy szkriptre mindkettő érvényes, a késleltetés élvez elsőbbséget, a halasztás tartalékként marad. Ha minden szkriptet késleltetsz, a halasztás a kivételként megadott szkripteknél továbbra is hasznos.

## Minifikálás

A minifikálás eltávolítja a felesleges karaktereket a kódból (szóközök, megjegyzések, rövidebb függvény- és változónevek), így kisebb lesz a fájl. A `.min.js` végű fájlokat a bővítmény kihagyja, és csak azokat cseréli le, amelyek valóban kisebbek lesznek.

1. Nyisd meg a **JavaScript** fület.
2. A **Minifikálás** szakaszban kapcsold be a **JavaScript minifikálása** kapcsolót.
3. Kattints a **Módosítások mentése** gombra.

A minifikált fájlok a `/wp-content/cache/perfmatters/<oldalnév>/minify` mappába kerülnek.

| Beállítás | Mit csinál |
| --- | --- |
| **JavaScript minifikálása** | Eltávolítja a felesleges karaktereket a JavaScript-fájlokból, és az eredeti helyett a minifikált verziót tölti be. |
| **Minifikálásból kizárva** | Azok a fájlok, amelyeket nem szabad minifikálni. Soronként egy fájlnév (például `script.js`), az eredeti nevet add meg, nem a minifikáltat. |
| **Minifikált JS törlése** | Törli az összes eddig létrehozott minifikált JavaScript-fájlt. |

Egy oldalt vagy bejegyzést kivehetsz a minifikálásból, ha a szerkesztő jobb oldali paneljén kiszeded a **Minify JavaScript** jelölőnégyzetet.

Ha tervezési vagy kódváltozás után a módosítások nem látszanak, töröld a minifikált fájlokat a **Minifikált JS törlése** gombbal. Javasolt gyorsítótár-törlési sorrend: sablon, harmadik féltől származó bővítmények, Perfmatters (**Használt CSS törlése**, **Minifikált JS törlése**, **Minifikált CSS törlése**), tárhely, végül CDN. A változásokat privát böngészőablakban ellenőrizd.

Ha egy másik bővítmény is minifikálja a JavaScriptet, az ütközések elkerülése érdekében csak az egyikben hagyd bekapcsolva.

Késleltetéssel és halasztással ellentétben a minifikálásnál ritkán kell kivételt megadni. A PageSpeed Insights a nem minifikált fájlra „Minify JavaScript” figyelmeztetést ad, ami az FCP-t és az LCP-t is rontja. Gyors ellenőrzés: a minifikált fájl neve `.min.js`-re végződik.

A minifikált JavaScript törlését az admin sávból is elvégezheted. Programból így töröld:

```php
Perfmatters\Minify::clear_minified('js');
```

Egy fájlt programból így zárhatsz ki a minifikálásból (a példában csak az önálló bejegyzéseknél):

```php
add_filter('perfmatters_minify_js_exclusions', function($exclusions) {
    if (is_single()) {
        $exclusions[] = 'example.js';
    }
    return $exclusions;
});
```

## Hibaelhárítás

- **Kapcsold ki az összevonást.** A késleltetés csak akkor működik megbízhatóan, ha a többi bővítmény (például Autoptimize, LiteSpeed Cache, WP Rocket) JavaScript-összevonása ki van kapcsolva. Avadánál kapcsold ki a JS-fordítót.
- **Google Analytics.** Késleltetés esetén az Analytics kicsit kevesebb adatot mutathat, mert a szkript csak felhasználói művelet után fut. A visszapattanási arány is változhat.
- **A mobilmenü az első kattintásra nem működik.** Valószínűleg a menüt működtető szkriptre kivételt kell felvenned.
- **Kivételek szűkítése.** Gyors módja annak, hogy kiderítsd, melyik szkript okozza a hibát: ideiglenesen vedd fel kivételnek a teljes könyvtárakat (`/themes/`, `/plugins/`, `/wp-includes/`), majd egyenként „kommentezd ki” őket úgy, hogy a sor elé `--` jelet írsz. Ha beágyazott szkript is gyanús, ideiglenesen kizárhatod az összes beágyazott szkriptet ezzel a sorral: `;{`.
