preconnect

preconnect("https://example.com");

• Reference
  • preconnect(href)
• שימוש
  • Preconnect בזמן רינדור
  • Preconnect בתוך event handler

Reference

preconnect(href)

כדי לבצע preconnect ל-host, קראו לפונקציה preconnect מתוך react-dom.

import { preconnect } from 'react-dom';

function AppRoot() {
  preconnect("https://example.com");
  // ...
}

ראו דוגמאות נוספות בהמשך.

הפונקציה preconnect מספקת לדפדפן רמז שכדאי לפתוח חיבור לשרת הנתון. אם הדפדפן בוחר לעשות זאת, זה יכול להאיץ טעינה של משאבים מהשרת הזה.

Parameters

• href: מחרוזת. ה-URL של השרת שאליו רוצים להתחבר.

Returns

preconnect לא מחזירה דבר.

Caveats

• כמה קריאות ל-preconnect עם אותו שרת משפיעות כמו קריאה אחת.
• בדפדפן אפשר לקרוא ל-preconnect בכל מצב: בזמן רינדור קומפוננטה, בתוך effect, בתוך event handler, וכן הלאה.
• ברינדור צד שרת או ברינדור Server Components, ל-preconnect יש השפעה רק אם קוראים לה בזמן רינדור קומפוננטה או בהקשר async שמקורו ברינדור קומפוננטה. קריאות אחרות ייחסמו.
• אם אתם יודעים אילו משאבים ספציפיים תצטרכו, אפשר לקרוא לפונקציות אחרות שמתחילות לטעון את המשאבים מיד.
• אין תועלת ב-preconnect לאותו שרת שעליו מתארח דף הווב עצמו, כי החיבור אליו כבר פתוח עד לרגע שבו היה ניתן הרמז.

שימוש

Preconnect בזמן רינדור

קראו ל-preconnect בזמן רינדור קומפוננטה אם אתם יודעים שהילדים שלה יטענו משאבים חיצוניים מאותו host.

import { preconnect } from 'react-dom';

function AppRoot() {
  preconnect("https://example.com");
  return ...;
}

Preconnect בתוך event handler

קראו ל-preconnect בתוך event handler לפני מעבר לעמוד או מצב שבהם יידרשו משאבים חיצוניים. כך התהליך מתחיל מוקדם יותר לעומת קריאה בזמן רינדור העמוד או המצב החדש.

import { preconnect } from 'react-dom';

function CallToAction() {
  const onClick = () => {
    preconnect('http://example.com');
    startWizard();
  }
  return (
    <button onClick={onClick}>Start Wizard</button>
  );
}