حِزم SDK
SDK .NET
NanoFlags الأعلام محليًا ودون أي عملية إدخال/إخراج، على إعداد موقّع في الذاكرة تُبقيه محدّثًا في الخلفية عبر الاتصال الحي. ولا ترمي القراءات استثناءً ولا تحجب التنفيذ أبدًا، ويمكن مشاركة عميل واحد بأمان بين الخيوط.في هذه الصفحة
التثبيت
dotnet add package NanoFlags
dotnet add package NanoFlags.OpenFeature # optional: OpenFeature provider- منشورة على NuGet باسم NanoFlags 0.2.0 وNanoFlags.OpenFeature 0.2.0. تستهدف
netstandard2.0وnet8.0، فتعمل على .NET 8 وما بعده، وعلى .NET Framework وغيره من بيئات .NET Standard 2.0. - الاعتمادية الوحيدة هي
Microsoft.Extensions.Logging.Abstractions. والتحقق من Ed25519 تنفيذ مستقل لمعيار RFC 8032، فلا حاجة إلى تشفير أصلي أو مكتبة خارجية. - مساحة الأسماء
NanoFlags(العميل) وNanoFlags.OpenFeature(المزوّد). والمحرك فيNanoFlags.Engineنقلٌ لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى. وتحليل الأرقام وتنسيقها دقيقان، فلا تتوقف النتائج على بيئة التشغيل. - برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/dotnet.
البدء السريع
انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. واشترك في الحدث Error مباشرة بعد إنشاء العميل، قبل انتظار الجاهزية.
using NanoFlags;
var flags = NanoFlagsClient.Create(
Environment.GetEnvironmentVariable("NANOFLAGS_SDK_KEY")!, // nf_srv_… (server view)
new NanoFlagsOptions { Service = "checkout-api" }); // shown in "which revision is each service running"
flags.Error += (_, e) => Console.Error.WriteLine($"nanoflags {e.Code}: {e.Message}");
if (!await flags.WaitForReadyAsync(TimeSpan.FromSeconds(5))) // never throws
Console.WriteLine($"flags not loaded yet ({flags.LastError?.Message}): evaluations return their fallbacks");
var user = new Dictionary<string, object?> { ["key"] = "user-42", ["plan"] = "pro", ["country"] = "SA" };
if (flags.BoolVariation("new-checkout", user, false))
{
// ...
}
await flags.CloseAsync(); // on shutdown (or Dispose())- أنشئ عميلًا واحدًا لكل مفتاح SDK عند بدء التشغيل وشاركه، فهو آمن للاستخدام من عدة خيوط. والعنوان الأساسي افتراضيًا هو الحافة المستضافة
https://edge.nanoflags.io. - يبدأ العميل التحميل فور عودة
Create، فقد يصل خطأ المحاولة الأولى قبل ربط معالجك؛ لكنLastErrorيحمل دائمًا آخر خطأ. - تعمل مفاتيح المتصفح (
nf_pub_…) أيضًا لكنها لا ترى إلا الأعلام المكشوفة للعميل. ولا ترميCreateالاستثناءNanoFlagsException(بالرمزConfig) إلا لمفتاح فارغ أو عنوان أساسي ليس http(s).
ASP.NET Core
builder.Services.AddSingleton(_ =>
{
var client = NanoFlagsClient.Create(
builder.Configuration["NanoFlags:SdkKey"]!,
new NanoFlagsOptions { Service = "web" });
client.Error += (_, e) => Console.Error.WriteLine($"nanoflags {e.Code}: {e.Message}");
return client;
});
// in a handler
app.MapGet("/checkout", (NanoFlagsClient flags, HttpContext http) =>
flags.BoolVariation("new-checkout", new Dictionary<string, object?> { ["key"] = http.User.Identity?.Name }, false)
? Results.Ok("new") : Results.Ok("classic"));سجّل العميل كخدمة singleton. تتخلّص منه الحاوية عند الإيقاف، فيُرسل القياس ويتوقف العمل في الخلفية. ومرّر ILogger في NanoFlagsOptions.Logger لتمرّ سجلاته عبر إعدادات التسجيل لديك.
القراءات المُنمَّطة
كل دالة قراءة تأخذ مفتاح العلم والسياق والقيمة الاحتياطية. والسياق من النوع IReadOnlyDictionary<string, object?> (ويصلح Dictionary<string, object?>)؛ و"key" هو الهوية المستخدمة في الطرح بالنسب المئوية. ويمكن أن تكون القيم نصوصًا أو قيمًا منطقية أو أي نوع رقمي أو null أو متتاليات أو قواميس.
bool enabled = flags.BoolVariation("new-checkout", user, false);
string accent = flags.StringVariation("accent", user, "blue");
double ratio = flags.DoubleVariation("sample-ratio", user, 0.1);
int limit = flags.IntVariation("rate-limit", user, 100);
long quota = flags.LongVariation("quota-bytes", user, 1_000_000L);
object? layout = flags.JsonVariation("layout", user, null); // null, bool, double, string, List<object?>, Dictionary<string, object?>
var every = flags.AllFlags(user); // records no telemetry| الدالة | تعيد |
|---|---|
BoolVariation(key, context, fallback) | قيمة bool |
StringVariation · DoubleVariation | قيمة string، أو double منتهية |
IntVariation · LongVariation | عددًا صحيحًا |
JsonVariation(key, context, fallback) | بيانات .NET عادية: null أو bool أو double أو string أو List<object?> أو Dictionary<string, object?> (بترتيب الإعداد) |
JsonValueVariation(key, context, fallback) | القيمة نفسها ككائن JsonValue بأنواع جافاسكريبت |
…VariationDetail(key, context, fallback) | كائن EvaluationDetail<T>، انظر التفاصيل والأسباب |
Evaluate(key, context, fallback) | نتيجة المحرك دون فحص للنوع |
AllFlags(context) · AllFlagsDetail(context) | كل أعلام الإعداد المحمَّل (دون قياس) |
تحصل على قيمتك الاحتياطية عندما لم يُحمَّل إعداد بعد، أو عندما يكون العلم مجهولًا، أو عندما يقدّم قيمة من نوع آخر (السبب FlagNotFound أو Error). والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له.
التفاصيل والأسباب
var d = flags.BoolVariationDetail("new-checkout", user, false);
Console.WriteLine($"{d.Value} {d.Reason} {d.RuleId} r{d.Revision}"); // True RuleMatch beta r63
foreach (var step in d.Trace) // the same steps the dashboard shows
Console.WriteLine(step);| الخاصية | المعنى |
|---|---|
Value | القيمة المقدَّمة (قيمتك الاحتياطية في حالات الاحتياط). |
Reason | RuleMatch، Default (لم تطابق قاعدة)، Off (العلم معطّل)، FlagNotFound، Error (نوع خاطئ أو إعداد مشوّه) |
RuleIndex · RuleId | القاعدة المطابقة (فهرس يبدأ من الصفر) ومعرّفها. |
InRollout · Bucket | للطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99). |
Revision | نسخة الإعداد التي جاءت منها النتيجة. |
Trace | قائمة من TraceStep تشرح القرار خطوة بخطوة. |
Error | لماذا كان Reason هو Error. |
التحديثات الحيّة والأحداث
يفتح العميل اتصال WebSocket واحدًا إلى wss://edge.nanoflags.io/v1/live (بالبروتوكول الفرعي nanoflags.v1، وينتقل المفتاح في ترويسة Authorization، لا في العنوان أبدًا). وتدفع الحافة كل نسخة منشورة موقّعةً مسبقًا؛ فيتحقق منها العميل ويستبدلها ذرّيًا.
flags.Changed += (_, e) =>
Console.WriteLine($"now on r{e.Revision} (was r{e.PreviousRevision}) via {e.Transport}, {e.Latency?.TotalMilliseconds} ms after commit");
flags.StatusChanged += (_, status) => Console.WriteLine($"nanoflags status: {status}"); // NotReady, Ready or Stale| الخاصية | المعنى |
|---|---|
Revision · PreviousRevision | النسخة الجديدة والنسخة التي حلّت محلها (-1 للأولى). |
Checksum | المجموع الاختباري للإعداد الجديد. |
Source | Network أو Store أو Bootstrap |
Transport | Live (مدفوعة)، أو Stream (جُلبت بعد إشعار من أحداث الخادم)، أو Poll |
Latency | قيمة TimeSpan? من لحظة الحفظ في قاعدة البيانات إلى هذا الحدث، للنسخ المدفوعة التي تحمل وقت حفظها. وهي تقارن بين ساعتين. |
- تعمل المعالجات واحدًا تلو الآخر، بالترتيب، على خيط تابع للعميل. اجعلها قصيرة؛ والمعالج الذي يرمي استثناءً لا يعطّل العميل أبدًا. وافصلها بـ
-=. - البدائل: إن تعذّر فتح المقبس يستخدم العميل أحداث الخادم (
/v1/stream) ويستطلع/v1/bundleمعETagكل 30 ثانية. وما دام المقبس سليمًا يعمل استطلاع احتياطي كل 5 دقائق. وتتباعد محاولات إعادة الاتصال من ثانية واحدة حتى 5 دقائق مع تذبذب عشوائي. وانظر وسائل النقل لتفاصيل البروتوكول. - لا تحلّ إجابة HTTP أقدم محل نسخة مدفوعة أبدًا، ولا تعيد إجابةٌ من الحافة موسومة بـ
X-NanoFlags-Staleالعميلَ إلى الوراء.
الجاهزية والحالة
bool inUse = await flags.Ready; // Task<bool>: completes after the first load attempt, never faults
bool ok = flags.WaitForReady(TimeSpan.FromSeconds(5)); // synchronous variant
Status status = flags.Status; // Status.NotReady | Status.Ready | Status.Stale
long revision = flags.Revision; // revision in use, or -1
Transport transport = flags.Transport; // Transport.Live | Transport.Stream | Transport.Poll
var lastError = flags.LastError; // the error of the last failed request, or null- تكتمل
Readyحين تنتهي محاولة التحميل الأولى:trueإن كان هناك إعداد قيد الاستخدام. وتحدّWaitForReadyAsync(timeout)وWaitForReady(timeout)مدة الانتظار. ولا يرمي أيٌّ منها استثناءً عند الفشل. Ready: الإعداد معروف أنه محدّث.Stale: هناك إعداد قيد الاستخدام لكن لا يُعرف أنه محدّث (استُعيد من المخزن، أو تعذّر الوصول إلى الحافة، أو حُذفت البيئة).NotReady: لم يُحمَّل شيء، وكل قراءة تعيد قيمتها الاحتياطية.- لا تجعل أي طلب ينتظر الجاهزية. انتظر مرة واحدة عند بدء التشغيل بمهلة قصيرة، ودع قيمك الاحتياطية تغطي الباقي.
آخر إعداد سليم والتهيئة المسبقة
بعد التحميل يبقى آخر إعداد سليم قيد الاستخدام رغم أعطال الشبكة والحزم المرفوضة وأخطاء الحافة (فتصبح Status بقيمة Stale).
var options = new NanoFlagsOptions
{
Service = "checkout-api",
Store = new FileStore("/var/cache/app/flags.json"), // keep the last good bundle across restarts
};
// Or start from a bundle you ship, served until the edge answers:
var offline = new NanoFlagsOptions { BootstrapJson = File.ReadAllText("flags-bootstrap.json") };- يكتب
FileStoreذرّيًا، بصلاحيات للمالك وحده على أنظمة Unix. ويُتحقَّق من النسخة المستعادة مجددًا قبل استخدامها. ونفّذ الواجهةIStoreلحفظها في مكان آخر. - تأخذ
Bootstrap(كائنBundle) وBootstrapJsonإعدادًا تشحنه مع تطبيقك؛ والإعداد غير الصالح يُتجاهل ويُبلَّغ عنه بالرمزInvalidBundle. - يحمل المخزن قواعد الأعلام، ولا يحمل مفتاح الـ SDK أبدًا.
التحقق من التوقيع
تُفحص كل حزمة (Ed25519، حسب معرّف المفتاح) قبل أن تحلّ محل الحزمة المستخدمة: عبر الاستطلاع والمقبس الحي والنسخة المخزّنة على حد سواء. ومع العنوان الأساسي الافتراضي يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الحزمة (NanoFlagsOptions.OfficialSigningKeys)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة كما قُدّمت تمامًا.
// Self-hosted or proxied edge: pin your keys and require signatures
var options = new NanoFlagsOptions
{
BaseUrl = "https://flags.internal.example",
Verify = new VerifyOptions
{
PublicKeys = { Jwk.Ed25519("…base64url public key…", "k1") },
Require = true,
},
};- الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى السابقة، ويُطلق الحدث
ErrorبالرمزSignature. - الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تجعل العميل يحمّل
GET /v1/keysمرة واحدة، وعلى الأكثر مرة في الدقيقة. ويحمّلFetchKeys = trueالمفاتيح من الحافة بدل تثبيتها؛ والمفاتيح المثبّتة أقوى. - تُربط الحزم بأول بيئة وُقّعت لها. ومع عنوان أساسي آخر يكون التحقق معطّلًا ما لم تضبط
Verify؛ ويعطّلهDisableVerification = trueصراحةً. - تُرفض الحزمة المكتوبة لمحرك تقييم أحدث من
NanoFlagsClient.SupportedEngineVersion(بالرمزEngine) ويبقى الإعداد الحالي: حدّث الحزمة. والسلسلة المعيارية موصوفة في التواقيع.
القياس والإخفاء
تُرسل عيّنة 10 % من التقييمات كل 10 ثوانٍ، مع بلاغ خدمة كل 60 ثانية. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يحمل الحدث إلا أسماء الخصائص التي تستخدمها قواعد العلم مع أنواع قيمها ({"plan": "string"}).
var options = new NanoFlagsOptions
{
Events = new EventsOptions
{
SampleRate = 0.05,
Redact = ctx => new Dictionary<string, object?> { ["plan"] = ctx.TryGetValue("plan", out var p) ? p : null },
},
};
var quiet = new NanoFlagsOptions { Events = EventsOptions.Disabled }; // no telemetry at allتتلقى Redact نسخة من سياق التقييم وتعيد القاموس الذي يُرسل بدل الافتراضي. ويعطّل EventsOptions.Disabled القياس كله، بما فيه بلاغ الخدمة. ويرسل FlushAsync() الأحداث المنتظرة فورًا.
جلسات الاختبار
تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بسياق الجلسة وقد غطّاه سياق الاستدعاء (والغلبة للاستدعاء)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.
var s = await flags.SessionAsync(Request.Headers[NanoFlagsClient.SessionHeader].FirstOrDefault()); // or (token, "checkout-api")
s.BoolVariation("checkout-v2", ctx, false); // session bundle while active
_ = (s.IsActive, s.Id, s.ExpiresAt, s.Revision);لكل طلب، دون تمرير المقيّم من دالة إلى أخرى: يحتفظ NanoFlagsSession بالجلسة الحالية في AsyncLocal يتبع الطلب عبر عمليات await. ولا يحتاج ASP.NET Core إلى حزمة إضافية؛ تكفي بضعة أسطر من الوسيط:
app.Use(async (http, next) =>
{
using (NanoFlagsSession.Begin(http.Request.Headers[NanoFlagsSession.Header].FirstOrDefault()))
{
await NanoFlagsSession.FlagsForAsync(flags); // resolve once, before the endpoint runs
await next();
}
});
app.MapGet("/cart", () => NanoFlagsSession.FlagsFor(flags).BoolVariation("checkout-v2", ctx, false));
// The next service joins the session: every request of this HttpClient carries the header.
builder.Services.AddHttpClient("pricing").AddHttpMessageHandler(() => new NanoFlagsSessionHandler());
// Queues, jobs and tests
await NanoFlagsSession.RunAsync(job.SessionToken, async () => { var f = await NanoFlagsSession.FlagsForAsync(flags); /* … */ });| الواجهة | الوصف |
|---|---|
client.SessionAsync(token, service?, ct) · Session(token, service?) | تحلّ الجلسة (GET /v1/session) وتعيد SessionEvaluator؛ ويُرسل service كـ X-NanoFlags-Service (افتراضيًا: Service)؛ ولا ينهي ct إلا الانتظار. |
SessionEvaluator | دوال القراءة الخاصة بالعميل، ومعها IsActive وId وExpiresAt وRevision. |
NanoFlagsSession.Begin(token) · Run · RunAsync | تجعل token الجلسة الحالية لهذا التدفق غير المتزامن (والتخلّص منها يستعيد السابقة)؛ والرمز الغائب أو المشوّه يعمل خارج أي جلسة. |
NanoFlagsSession.FlagsForAsync(client, service?, ct) | مقيّم الطلب الحالي، يُحلّ مرة واحدة لكل نطاق وعميل؛ وخارج الجلسة يتصرّف كالعميل. |
NanoFlagsSession.FlagsFor(client) | متزامنة ولا تحجب أبدًا: المقيّم الذي حلّته FlagsForAsync، وإلا مقيّم يتصرّف كالعميل. |
NanoFlagsSession.CurrentSession · Headers() | الرمز الحالي (أو null)؛ و{x-nanoflags-session: token} (أو فارغ). |
NanoFlagsSessionHandler | DelegatingHandler يضيف الترويسة إلى طلبات HttpClient الصادرة داخل الجلسة. |
NanoFlagsClient.SessionHeader · IsSessionToken(s) | "x-nanoflags-session"؛ والرمز من 1 إلى 512 محرفًا ASCII قابلًا للطباعة. |
- تُسأل الحافة مرة واحدة لكل رمز وخدمة، ويتشارك المستدعون المتزامنون الطلب نفسه، ويُخزَّن الجواب مؤقتًا حتى تنتهي الجلسة. وتُتذكَّر الرموز المجهولة 15 ثانية، وعمليات البحث الفاشلة (المبلَّغ عنها برمز الخطأ
Session) 3 ثوانٍ. - لا ترمي استثناءً أبدًا: الرمز الغائب أو المشوّه أو المجهول أو المنتهي أو الملغى أو غير المسموح به يعود إلى الإعداد العادي، ويتصرّف المقيّم تمامًا كالعميل. وإن انتهت الجلسة أثناء الطلب تصبح غير نشطة وتستمر التقييمات على الإعداد المنشور. ولا تغيّر نسخةٌ منشورة حديثًا جلسةً نشطة.
- تُمرَّر الجلسة المجهولة إلى الخدمات التالية مع ذلك: الخدمة التالية تقرّر بنفسها.
- تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط؛ فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل في عملية خزّنتها مؤقتًا حتى وقت انتهائها.
مزوّد OpenFeature
dotnet add package NanoFlags.OpenFeatureusing NanoFlags;
using NanoFlags.OpenFeature;
using OpenFeature;
using OpenFeature.Model;
var flags = NanoFlagsClient.Create(Environment.GetEnvironmentVariable("NANOFLAGS_SDK_KEY")!);
await Api.Instance.SetProviderAsync(new NanoFlagsProvider(flags, closeClient: true));
var client = Api.Instance.GetClient();
var on = await client.GetBooleanValueAsync("new-checkout", false,
EvaluationContext.Builder().SetTargetingKey("user-42").Set("plan", "pro").Build());- للـ SDK الرسمي في .NET (
OpenFeature2.x). ويبقى التقييم محليًا: يغلّف المزوّد العميل أعلاه، فتعمل التحديثات الحيّة والتواقيع وآخر إعداد سليم بالطريقة نفسها. - يصبح مفتاح الاستهداف هو
keyفي NanoFlags (ويتقدّم على خاصية اسمهاkey). الأسباب:DISABLEDوDEFAULTوTARGETING_MATCHوSPLIT(الطرح بالنسب المئوية). والأخطاء:FLAG_NOT_FOUNDوPROVIDER_NOT_READYوTYPE_MISMATCHوGENERAL. والمتغيّر (variant) هو معرّف القاعدة؛ وتحمل بيانات العلم الوصفيةrevisionوruleIndex. - يطلق المزوّد الأحداث
PROVIDER_READYوPROVIDER_STALEوPROVIDER_ERRORوPROVIDER_CONFIGURATION_CHANGEDمع مفاتيح الأعلام التي تغيّرت. - المُنشئ:
new NanoFlagsProvider(client, closeClient: false, initTimeout: null). يغلقcloseClient: trueعميل NanoFlags عند إيقاف المزوّد؛ ويحدّinitTimeoutمدة التهيئة (10 ثوانٍ افتراضيًا).
الخيارات
| الخاصية | الافتراضي | الوصف |
|---|---|---|
BaseUrl | https://edge.nanoflags.io | عنوان الحافة. |
Service | "unknown" | الاسم الذي تُبلّغ به هذه العملية. |
HttpClient | ينشئه الـ SDK | يستخدم إعدادات الوسيط في النظام (مثل HTTPS_PROXY). |
PollInterval · LivePollInterval | 30 ث · 5 د | TimeSpan.Zero يعطّل الاستطلاع. |
Live · Streaming | true | لتعطيل WebSocket أو أحداث الخادم. |
Store · Bootstrap · BootstrapJson | لا شيء | انظر آخر إعداد سليم. |
Verify · DisableVerification | مفعّل للحافة المستضافة | انظر التحقق من التوقيع. |
Events | عيّنة 10 % | انظر القياس. |
RequestTimeout · LiveConnectTimeout | 10 ث · 10 ث | مهلتا طلب HTTP والاتصال عبر WebSocket. |
Logger | لا شيء | كائن ILogger. |
رموز الأخطاء
تطلق أعطال الخلفية الحدث Error مع NanoFlagsException له Code (وHttpStatus عند الحاجة): Network وUnauthorized وHttp وInvalidBundle وStore وConfig وSignature وSession وEngine وEnvironmentDeleted. ولا تغيّر هذه الأعطال الإعداد المستخدم، ولا يُرمى أي شيء من استدعاء قراءة. والمعاني مطابقة لـ SDK جافاسكريبت.
الإغلاق والإيقاف
await flags.CloseAsync(); // or flags.Dispose()
// or scope it
using (var job = NanoFlagsClient.Create(sdkKey, new NanoFlagsOptions { Service = "nightly-job" }))
{
Run(job);
}- يرسل
CloseAsync()وDispose()القياس المنتظر (بأفضل جهد) ويوقفان العمل في الخلفية. واستدعاء أيٍّ منهما أكثر من مرة آمن. - بعد الإغلاق تواصل القراءات العمل على آخر إعداد، لكنه يتوقف عن التحديث فقط. ويعيد
RefreshAsync()التحقق فورًا، ويرميNanoFlagsExceptionإن فشل ذلك الطلب.
حل المشكلات
- كل قراءة تعيد القيمة الاحتياطية. افحص
StatusوLastError. يعنيUnauthorizedأن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل. - خلف وسيط أو مع معالج HTTP مخصّص. يستخدم
HttpClientالذي ينشئه الـ SDK إعدادات الوسيط في النظام؛ ومرّرHttpClientخاصًا بك لأي شيء آخر. وإن حُجبت ترقية WebSocket يعرضTransportالقيمةStreamأوPoll. - أخطاء بالرمز
Signature. لم تجتز الحزمة التحقق فلم تُستخدم. ومعBaseUrlمخصّص ثبّت مفاتيح تلك الحافة عبرVerifyOptions. - أخطاء بالرمز
EnvironmentDeleted. أغلقت الحافة المقبس بالرمز 4004. يتوقف العميل عن إعادة الاتصال ويُبقي آخر إعداد بحالةStale؛ استبدل المفتاح.