العميل والخدمات
نقطة دخول SDK: كيفية إنشاء العميل والخدمات التي يعرضها.
6 د قراءة·المستوى مرجع·تمت المراجعة في 12/10/2026
تم إنشاء هذا النص الإنجليزي تلقائيًا من النص الأصلي الفرنسي ولم تتم مراجعته بعد.
تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.
#
وظائف
الوظائف المصدرة
| وظيفة | الوصف |
|---|---|
function createClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database> | قم بإنشاء مثيل عميل Aurabase جديد. |
function createAdminClient<Database = any>(baseUrl: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database> | إنشاء عميل لخادم يستخدم فقط لعمليات الإدارة (client.authAdmin: قائمة/إنشاء/حظر المستخدمين، قراءة التدقيق). |
#
فئة
AuraClient
العميل الرئيسي Aurabase.
| الملكية | الوصف |
|---|---|
readonly baseUrl: string | عنوان URL للمشروع (https://<slug>.aurabase.cloud)، بدون شريط زائد. |
readonly apiKey: string | null | مفتاح واجهة برمجة تطبيقات المشروع (anon أو service_role) تم إرساله في الرأس apikey؛ null إذا لم يتم توفير أي شيء. |
readonly fetchFn: typeof globalThis.fetch | الدالة fetch تستخدم لجميع الاستعلامات (التي options.fetch، وإلا globalThis.fetch). |
readonly authStore: BaseAuthStore | مخزن الجلسة (رمز الوصول، رمز التحديث، المستخدم): الذاكرة، localStorage أو ملفات تعريف الارتباط حسب السياق. |
readonly retryConfig: { enabled: boolean; maxRetries: number; } | اقرأ سياسة استئناف الطلب (GET, HEAD) بشأن الخطأ العابر: ممكّن أم لا، والحد الأقصى لعدد عمليات الاستئناف. |
readonly requestTimeoutMs?: number | المهلة الافتراضية (بالمللي ثانية) لطلبات JSON بدون إشارة. undefined → الخطأ الأساسي (30 ثانية). |
readonly onEvent?: (event: AuraObservabilityEvent) => void | ربط إمكانية الملاحظة - راجع AuraClientOptions.onEvent. |
readonly debug?: boolean | قم بالصحافة كل AuraObservabilityEvent عبر console.debug — مشاهدة AuraClientOptions.debug. |
get auth(): AuthService | خدمة المصادقة: التسجيل، الاتصال، الجلسة، MFA، OAuth، الهويات. |
get authAdmin(): AuthAdminService | واجهة برمجة تطبيقات إدارة المصادقة (المستخدمون، الجلسات، سجل التدقيق، قوالب البريد الإلكتروني). |
get db(): DatabaseService<Database, Schema> | خدمة قاعدة البيانات: الاستعلامات على الجداول وطرق العرض، واستدعاءات وظائف SQL (rpc)، وSQL الأولية. |
get storage(): StorageService | خدمة التخزين: الدلاء، الإرسال، التنزيل، عناوين URL الموقعة والعامة، تحويلات الصور. |
get realtime(): RealtimeService | الخدمة في الوقت الحقيقي: القنوات، Postgres التغييرات، البث (broadcast) والحضور. |
get functions(): FunctionsService | خدمة Edge Functions: الاستدعاء وإدارة الوظائف والكرون بمفتاح service_role. |
get ai(): AiService | خدمة الذكاء الاصطناعي: المحادثة (chat) والتضمينات وRAG (الاستقبال والاستعلامات ومساحات الأسماء) والبحث الدلالي والجلسات. |
get notifications(): NotificationsService | خدمة الإشعارات: الإرسال (البريد الإلكتروني، الرسائل النصية القصيرة، الدفع، الخطاف عبر الويب)، السجل، القوالب والإدارة. |
| الطريقة | الوصف |
|---|---|
dispose(): void | إلغاء تحميل العميل: إيقاف التحديث الاستباقي (الشريط + الرؤية + قناة البث)، وقطع الاتصال بالوقت الفعلي، وإفراغ مستمعي المصادقة. |
from<TableName extends string & keyof Schema['Tables'], Table extends Schema['Tables'][TableName]>(table: TableName): AuraQueryBuilder<Schema, Table, TableName, AuraClientOptionsT>from<ViewName extends string & keyof Schema['Views'], View extends Schema['Views'][ViewName]>(view: ViewName): AuraQueryBuilder<Schema, View, ViewName, AuraClientOptionsT>from(table: string): AuraQueryBuilder<any, any, any, AuraClientOptionsT> | الاختصار: الاستعلام عن جدول أو عرض قاعدة بيانات (Supabase- واجهة برمجة التطبيقات المتوافقة). |
rpc<FnName extends string = string, Args extends Record<string, unknown> = Record<string, unknown>>(fn: FnName, args?: Args, options?: Parameters<DatabaseService<Database, Schema>['rpc']>[2]): ReturnType<DatabaseService<Database, Schema>['rpc']> | الاختصار: استدعاء الإجراء المخزن / وظيفة PostgreSQL عبر RPC (Supabase- واجهة برمجة التطبيقات المتوافقة). |
channel(name: string, options?: ChannelConfig): AuraChannel | الاختصار: أنشئ قناة في الوقت الفعلي باستخدام واجهة برمجة التطبيقات المتوافقة مع Supabase. |
removeChannel(channel: string | AuraChannel): void | الاختصار: قم بإزالة قناة في الوقت الفعلي بالاسم أو بمثيل AuraChannel. |
removeAllChannels(): void | الاختصار: قم بإزالة جميع قنوات الوقت الفعلي وإلغاء الاشتراك. |
getChannels(): AuraChannel[] | الاختصار: قم بإدراج جميع قنوات الوقت الفعلي النشطة. |
الصفحة التي تم إنشاؤها
يتم إنشاء هذه الصفحة من إعلانات النوع وتعليقات SDK، لذلك لا يمكن أن تنحرف عن التعليمات البرمجية المنشورة. للحصول على أمثلة عملية، اقرأ الأدلة.
آخر تحديث · 12/10/2026