اتصال

تتيح لك وظيفة connection() الإشارة إلى أن العرض يجب أن ينتظر طلبًا واردا من المستخدم قبل المتابعة.

هذه الوظيفة مفيدة عندما لا يستخدم المكون واجهات برمجة التطبيقات الديناميكية، ولكنك تريد أن يتم عرضه ديناميكيًا أثناء التشغيل وليس بشكل ثابت أثناء وقت البناء. يحدث هذا عادةً عندما تصل إلى معلومات خارجية تريد عمدًا أن تغير نتيجة العرض، مثل Math.random() أو new Date().

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // كل ما يلي سيتم استبعاده من العرض المسبق
  const rand = Math.random()
  return <span>{rand}</span>
}

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // كل ما يلي سيتم استبعاده من العرض المسبق
  const rand = Math.random()
  return <span>{rand}</span>
}

المرجع

النوع

function connection(): Promise<void>

المعاملات

• لا تقبل الوظيفة أي معاملات.

القيم المُرجعة

• تُرجع الوظيفة وعدًا (Promise) من النوع void. ليس المقصود استهلاك هذه القيمة.

معلومات مفيدة

• تحل connection محل unstable_noStore لتصبح أكثر توافقًا مع مستقبل Next.js.
• تكون الوظيفة ضرورية فقط عندما يكون العرض الديناميكي مطلوبًا ولا تُستخدم واجهات برمجة التطبيقات الديناميكية الشائعة.

سجل الإصدارات