# JavaScript késleltetett betöltése

> A defer attribútumos betöltés működése, kizárások fájlokra, tartományokra és beágyazott szkriptekre, példákkal.

Ha a **JavaScript késleltetett betöltése** be van kapcsolva, a böngésző először megjeleníti az oldalt, és a szkripteket később tölti be. A beállítás a **Beállítások → WP Rocket → Oldaloptimalizálás → JavaScript és CSS** oldalon van.

![A JavaScript-fájlok blokk a kizárási mezőkkel](./kepek/fajloptimalizalas-javascript-kizarasok.webp)

*A JavaScript-fájlok blokk a kizárási mezőkkel* (https://minta-bolt.hu/wp-admin/options-general.php?page=wprocket)

A **JavaScript késleltetett betöltése** bejelölése után megjelenik alatta a **Kizárt JavaScript-fájlok** mező.

Ha a PageSpeed „Megjelenítést blokkoló erőforrások kiküszöbölése” javaslata marad, lehet, hogy túl sok kritikus szkriptet zártál ki. Csökkentsd a kizárásokat a teljesítmény érdekében.

## Mit csinál?

A teljesítmény szempontjából az a jó, ha a JavaScript-fájlok az oldal láblécében töltődnek be, vagy késleltetettek, így nem blokkolják a többi erőforrás letöltését. A funkció bekapcsolásakor az oldal minden JavaScript-fájlja (a WP Rocket által minifikáltak is) ezekkel töltődik be:

- a `defer` attribútum,
- az egyéni `data-rocket-defer` attribútum, amely jelzi, hogy az optimalizálás a WP Rocketből ered.

```html
<script src="https://example.com/wp-includes/js/jquery/jquery.min.js" id="jquery-core-js" data-rocket-defer defer></script>
```

Ez azokra a szkriptekre is vonatkozik, amelyeknek van `src` attribútuma, de nincs `.js` kiterjesztésük. A jQuery-vel kapcsolatos beágyazott szkripteket is késlelteti a WP Rocket, így a `jquery.js` több esetben is késleltethető.

Fontos: a Google nem veszi figyelembe, hogy néha nem lehet minden JavaScriptet késleltetni anélkül, hogy az oldal elromlana. A kizárt fájlokat a PageSpeed kifogásolni fogja, de olykor ez szükséges a működéshez.

## Fájlok kizárása

Ha a funkció ütközik egy fájllal, zárd ki a **Kizárt JavaScript-fájlok** mezőben (soronként egyet). Megadhatsz:

- teljes fájl-webcímet (a lekérdezési paraméterek nélkül),
- a webcímből kulcsszavakat,
- helyettesítő karaktereket (wildcard).

Bizonyos kizárási minták nem kezelhetők, ezeket a WP Rocket automatikusan eltávolítja. Ilyenkor értesítés jelenik meg, hogy az alábbi minták érvénytelenek és el lettek távolítva.

### Beágyazott szkriptek kizárása

A beágyazott szkriptek kizárására a `rocket_defer_inline_exclusions` szűrő szolgál:

```php
add_filter( 'rocket_defer_inline_exclusions', function( $inline_exclusions_list ) {
  if ( ! is_array( $inline_exclusions_list ) ) {
    $inline_exclusions_list = array();
  }

  // Ismételd meg ezt a sort, ha többet kell kizárnod
  $inline_exclusions_list[] = 'key_from_target_script';

  return $inline_exclusions_list;
} );
```

A `key_from_target_script` helyére a kizárni kívánt szkript egyedi szavát írd. Olyan szót válassz, amely csak abban a szkriptben szerepel, mert minden szkriptet kizár, amelyben előfordul. Például a `<script id='kl-identify-browser-js-extra'> var klUser = {...}; </script>` szkriptnél jó választás a `kl-identify-browser-js-extra`.

Ha bármelyik jQuery-könyvtárat kizárod, a WP Rocket a beágyazott JavaScriptet sem késlelteti.

### Példák

**Külső fájl kizárása.** Ehhez a szkripthez: `<script src="//maps.googleapis.com/maps/api/js?key=...&libraries=places"></script>` elég a tartomány: `maps.googleapis.com`. Ez azokra a külső fájlokra igaz, amelyeket a WP Rocket nem minifikált, így megtartották az eredeti tartományukat.

**Egy fájl kizárása.** Ehhez: `https://example.org/wp-content/plugins/elementor-pro/assets/js/frontend.min.js?ver=3.0.5` add meg így (verzió nélkül): `https://example.org/wp-content/plugins/elementor-pro/assets/js/frontend.min.js`

**Fájlcsoport kizárása.** Egy bővítménymappa összes fájljához használhatsz helyettesítő karaktert: `/wp-content/plugins/my-plugin/assets/js/(.*).js`

**Minifikált fájl kizárása.** Ehhez: `https://www.example.org/wp-content/cache/min/1/wp-content/plugins/plugin-name/assets/js/pickadate/picker.time-f9a2f2b5fb728f25892f2f41b6f8a4b9.js` a minifikált webcím olyan részét válaszd (a tartomány nélkül), amelyet a minifikálás nem változtat: `plugin-name/assets/js/pickadate/picker.time`

## Technikai részletek

A `jquery.js` késleltethetősége érdekében a WP Rocket megkeresi a jQuery-t igénylő beágyazott szkripteket, és ezeket is késlelteti. Úgy teszi, hogy beburkolja őket:

```js
window.addEventListener('DOMContentLoaded', function() { /* az eredeti szkript */ });
```

Ezek a szkriptek valójában nem `defer` attribútumot kapnak, hanem a DOMContentLoaded eseménykor futnak le. A WP Rocket nem késlelteti azokat a beágyazott szkripteket, amelyek:

- tartalmazzák a `DOMContentLoaded` vagy a `document.write` szöveget,
- nem tartalmaznak jQuery-t, `$.(` vagy `$(,` jelölést.
