حِزم SDK
SDK جافا
io.nanoflags:nanoflags-java الأعلام محليًا ودون أي عملية إدخال/إخراج، على إعداد موقّع في الذاكرة تُبقيه محدّثًا في الخلفية عبر الاتصال الحي. ولا ترمي القراءات استثناءً ولا تحجب التنفيذ أبدًا، ويمكن مشاركة عميل واحد بأمان بين الخيوط.في هذه الصفحة
التثبيت
dependencies {
implementation("io.nanoflags:nanoflags-java:0.2.0")
implementation("io.nanoflags:nanoflags-java-openfeature:0.2.0") // optional: OpenFeature provider
}<dependency>
<groupId>io.nanoflags</groupId>
<artifactId>nanoflags-java</artifactId>
<version>0.2.0</version>
</dependency>- منشورة على Maven Central باسم io.nanoflags:nanoflags-java 0.2.0 وio.nanoflags:nanoflags-java-openfeature 0.2.0. تتطلب Java 11 أو أحدث (مختبَرة على 11 و17 و21).
- بلا اعتماديات وقت التشغيل: يستخدم HTTP وWebSocket المكتبة
java.net.httpالمضمّنة في JDK. ويُستخدم مزوّد Ed25519 في JDK على Java 15 فأحدث، ومتحقِّق RFC 8032 مدمج على Java 11 إلى 14. - الحزمتان
io.nanoflags.server(العميل) وio.nanoflags.server.openfeature(المزوّد). والمحرك فيio.nanoflags.server.engineنقلٌ لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى. - برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/java. أما تطبيقات Android فتستخدم SDK لـ Android وKotlin (مفاتيح العميل، ودورة حياة التطبيق، وCompose).
البدء السريع
انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. وسجّل مستمع الأخطاء مباشرة بعد إنشاء العميل، قبل انتظار الجاهزية.
import io.nanoflags.server.NanoFlagsClient;
import io.nanoflags.server.NanoFlagsOptions;
import java.time.Duration;
import java.util.Map;
NanoFlagsClient flags = NanoFlagsClient.create(
System.getenv("NANOFLAGS_SDK_KEY"), // nf_srv_… (server view)
NanoFlagsOptions.builder().service("checkout-api").build()); // shown in "which revision is each service running"
flags.onError(e -> log.warn("nanoflags {}: {}", e.code(), e.getMessage()));
if (!flags.waitForReady(Duration.ofSeconds(5))) { // never throws
log.warn("flags not loaded yet ({}): evaluations return their fallbacks", flags.lastError());
}
Map<String, Object> user = Map.of("key", "user-42", "plan", "pro", "country", "SA");
if (flags.boolVariation("new-checkout", user, false)) {
// ...
}
flags.close(); // on shutdown (it is AutoCloseable)- أنشئ عميلًا واحدًا لكل مفتاح SDK عند بدء التشغيل وشاركه، فهو آمن للاستخدام من عدة خيوط. والعنوان الأساسي افتراضيًا هو الحافة المستضافة
https://edge.nanoflags.io. - يبدأ العميل التحميل فور عودة
create، فقد يصل خطأ المحاولة الأولى قبل تسجيل مستمعك؛ لكنlastError()يحمل دائمًا آخر خطأ. - تعمل مفاتيح المتصفح (
nf_pub_…) أيضًا لكنها لا ترى إلا الأعلام المكشوفة للعميل. ولا ترميcreateالاستثناءNanoFlagsException(بالرمزCONFIG) إلا لمفتاح فارغ أو عنوان أساسي ليس http(s).
القراءات المُنمَّطة
كل دالة قراءة تأخذ مفتاح العلم والسياق والقيمة الاحتياطية. والسياق من النوع Map<String, ?>؛ و"key" هو الهوية المستخدمة في الطرح بالنسب المئوية. ويمكن أن تكون القيم نصوصًا أو قيمًا منطقية أو أي Number أو null أو مجموعات أو مصفوفات أو خرائط.
boolean 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, Map.of("cols", 3)); // null, Boolean, Double, String, List, Map
Map<String, Object> every = flags.allFlags(user); // records no telemetry| الدالة | تعيد |
|---|---|
boolVariation(key, context, fallback) | قيمة boolean |
stringVariation · doubleVariation | قيمة String، أو double منتهية |
intVariation · longVariation | عددًا صحيحًا |
jsonVariation(key, context, fallback) | بيانات جافا عادية: null أو Boolean أو Double أو String أو List أو Map (بترتيب الإعداد) |
jsonValueVariation(key, context, fallback) | القيمة نفسها ككائن JsonValue بأنواع جافاسكريبت |
…VariationDetail(key, context, fallback) | كائن EvaluationDetail<T>، انظر التفاصيل والأسباب |
evaluate(key, context, fallback) | نتيجة المحرك دون فحص للنوع |
allFlags(context) · allFlagsDetail(context) | كل أعلام الإعداد المحمَّل (دون قياس) |
تحصل على قيمتك الاحتياطية عندما لم يُحمَّل إعداد بعد، أو عندما يكون العلم مجهولًا، أو عندما يقدّم قيمة من نوع آخر (السبب FLAG_NOT_FOUND أو ERROR). والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له.
التفاصيل والأسباب
EvaluationDetail<Boolean> d = flags.boolVariationDetail("new-checkout", user, false);
d.value(); // true
d.reason(); // RULE_MATCH
d.ruleId(); // "beta"
d.revision(); // 63
d.trace().forEach(step -> System.out.println(step)); // the same steps the dashboard shows| الدالة | المعنى |
|---|---|
value() | القيمة المقدَّمة (قيمتك الاحتياطية في حالات الاحتياط). |
reason() | RULE_MATCH، DEFAULT (لم تطابق قاعدة)، OFF (العلم معطّل)، FLAG_NOT_FOUND، ERROR (نوع خاطئ أو إعداد مشوّه) |
ruleIndex() · ruleId() | القاعدة المطابقة (فهرس يبدأ من الصفر، و-1 إن لم توجد) ومعرّفها. |
inRollout() · bucket() | للطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99). |
revision() | نسخة الإعداد التي جاءت منها النتيجة. |
trace() | قائمة من TraceStep تشرح القرار خطوة بخطوة. |
error() | لماذا كان reason() هو ERROR. |
التحديثات الحيّة والمستمعات
يفتح العميل اتصال WebSocket واحدًا إلى wss://edge.nanoflags.io/v1/live (بالبروتوكول الفرعي nanoflags.v1، وينتقل المفتاح في ترويسة Authorization، لا في العنوان أبدًا). وتدفع الحافة كل نسخة منشورة موقّعةً مسبقًا؛ فيتحقق منها العميل ويستبدلها ذرّيًا.
Subscription sub = flags.onChange(e ->
log.info("now on r{} (was r{}) via {}", e.revision(), e.previousRevision(), e.transport()));
flags.onStatus(s -> log.info("nanoflags status: {}", s)); // NOT_READY, READY or STALE
sub.close(); // unregister| الدالة | المعنى |
|---|---|
revision() · previousRevision() | النسخة الجديدة والنسخة التي حلّت محلها (-1 للأولى). |
checksum() | المجموع الاختباري للإعداد الجديد ("" إن لم يكن معروفًا، كحزمة التهيئة المسبقة). |
source() | NETWORK أو STORE أو BOOTSTRAP |
transport() | LIVE (مدفوعة)، أو STREAM (جُلبت بعد إشعار من أحداث الخادم)، أو POLL |
latency() | قيمة Optional<Duration> من لحظة الحفظ في قاعدة البيانات إلى هذا الحدث، للنسخ المدفوعة التي تحمل وقت حفظها. وهي تقارن بين ساعتين. |
- تعمل المستمعات واحدًا تلو الآخر، بالترتيب، على خيط تابع للعميل. اجعلها قصيرة؛ والمستمع الذي يرمي استثناءً لا يعطّل العميل أبدًا. وكل دالة
on…تعيدSubscriptionتغلقه لإلغاء التسجيل. - البدائل: إن تعذّر فتح المقبس يستخدم العميل أحداث الخادم (
/v1/stream) ويستطلع/v1/bundleمعETagكل 30 ثانية. وما دام المقبس سليمًا يعمل استطلاع احتياطي كل 5 دقائق. وتتباعد محاولات إعادة الاتصال من ثانية واحدة حتى 5 دقائق مع تذبذب عشوائي. وانظر وسائل النقل لتفاصيل البروتوكول. - لا تحلّ إجابة HTTP أقدم محل نسخة مدفوعة أبدًا، ولا تعيد إجابةٌ من الحافة موسومة بـ
X-NanoFlags-Staleالعميلَ إلى الوراء.
الجاهزية والحالة
flags.ready().thenAccept(ok -> log.info("configuration in use: {}", ok)); // CompletableFuture<Boolean>, never fails
flags.status(); // NOT_READY | READY | STALE
flags.revision(); // revision in use, or -1
flags.transport(); // LIVE | STREAM | POLL
flags.lastError(); // the error of the last failed request, or null- يكتمل
ready()حين تنتهي محاولة التحميل الأولى:trueإن كان هناك إعداد قيد الاستخدام. وwaitForReady(Duration)ينتظر تلك المدة على الأكثر. ولا يرمي أيٌّ منهما استثناءً. READY: الإعداد معروف أنه محدّث.STALE: هناك إعداد قيد الاستخدام لكن لا يُعرف أنه محدّث (استُعيد من المخزن، أو تعذّر الوصول إلى الحافة، أو حُذفت البيئة).NOT_READY: لم يُحمَّل شيء، وكل قراءة تعيد قيمتها الاحتياطية.- لا تجعل أي طلب ينتظر الجاهزية. انتظر مرة واحدة عند بدء التشغيل بمهلة قصيرة، ودع قيمك الاحتياطية تغطي الباقي.
آخر إعداد سليم والتهيئة المسبقة
بعد التحميل يبقى آخر إعداد سليم قيد الاستخدام رغم أعطال الشبكة والحزم المرفوضة وأخطاء الحافة (فتصبح status() بقيمة STALE).
import io.nanoflags.server.FileStore;
import java.nio.file.Files;
import java.nio.file.Path;
NanoFlagsOptions options = NanoFlagsOptions.builder()
.service("checkout-api")
.store(new FileStore(Path.of("/var/cache/app/flags.json"))) // keep the last good bundle across restarts
.build();
// Or start from a bundle you ship, served until the edge answers:
NanoFlagsOptions offline = NanoFlagsOptions.builder()
.bootstrapJson(Files.readString(Path.of("flags-bootstrap.json")))
.build();- يكتب
FileStoreذرّيًا، بصلاحيات للمالك وحده حيث تتوفر صلاحيات POSIX. ويُتحقَّق من النسخة المستعادة مجددًا قبل استخدامها. ونفّذ الواجهةStoreلحفظها في مكان آخر. - تأخذ
bootstrap(Bundle)وbootstrapJson(String)إعدادًا تشحنه مع تطبيقك؛ والإعداد غير الصالح يُتجاهل ويُبلَّغ عنه بالرمزINVALID_BUNDLE. - يحمل المخزن قواعد الأعلام، ولا يحمل مفتاح الـ SDK أبدًا.
التحقق من التوقيع
تُفحص كل حزمة (Ed25519، حسب معرّف المفتاح) قبل أن تحلّ محل الحزمة المستخدمة: عبر الاستطلاع والمقبس الحي والنسخة المخزّنة على حد سواء. ومع العنوان الأساسي الافتراضي يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الحزمة (NanoFlagsOptions.OFFICIAL_SIGNING_KEYS)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة كما قُدّمت تمامًا.
import io.nanoflags.server.Jwk;
import io.nanoflags.server.VerifyOptions;
// Self-hosted or proxied edge: pin your keys and require signatures
NanoFlagsOptions options = NanoFlagsOptions.builder()
.baseUrl("https://flags.internal.example")
.verify(VerifyOptions.builder()
.publicKey(Jwk.ed25519("…base64url public key…", "k1"))
.require(true)
.build())
.build();- الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى السابقة، ويتلقى
onErrorالرمزSIGNATURE. - الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تجعل العميل يحمّل
GET /v1/keysمرة واحدة، وعلى الأكثر مرة في الدقيقة. ويحمّلfetchKeys(true)المفاتيح من الحافة بدل تثبيتها؛ والمفاتيح المثبّتة أقوى. - تُربط الحزم بأول بيئة وُقّعت لها. ومع عنوان أساسي آخر يكون التحقق معطّلًا ما لم تمرّر
verify(…)؛ ويعطّلهwithoutVerification()صراحةً. - تُرفض الحزمة المكتوبة لمحرك تقييم أحدث من
NanoFlagsClient.SUPPORTED_ENGINE_VERSION(بالرمزENGINE) ويبقى الإعداد الحالي: حدّث الحزمة. والسلسلة المعيارية موصوفة في التواقيع.
القياس والإخفاء
تُرسل عيّنة 10 % من التقييمات كل 10 ثوانٍ، مع بلاغ خدمة كل 60 ثانية. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يحمل الحدث إلا أسماء الخصائص التي تستخدمها قواعد العلم مع أنواع قيمها ({"plan": "string"}).
import io.nanoflags.server.NanoFlagsOptions.EventsOptions;
NanoFlagsOptions options = NanoFlagsOptions.builder()
.events(EventsOptions.builder()
.sampleRate(0.05)
.redact(ctx -> Map.of("plan", ctx.getOrDefault("plan", "unknown"))) // what leaves the process
.build())
.build();
NanoFlagsOptions quiet = NanoFlagsOptions.builder().events(EventsOptions.disabled()).build(); // no telemetry at allتتلقى redact نسخة من سياق التقييم وتعيد الخريطة التي تُرسل بدل الافتراضي. ويعطّل EventsOptions.disabled() القياس كله، بما فيه بلاغ الخدمة. ويرسل flush() الأحداث المنتظرة فورًا.
جلسات الاختبار
تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بسياق الجلسة وقد غطّاه سياق الاستدعاء (والغلبة للاستدعاء)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.
SessionEvaluator s = flags.session(request.getHeader(NanoFlagsClient.SESSION_HEADER)); // or session(token, "checkout-api")
s.boolVariation("checkout-v2", Map.of("key", userId), false); // session bundle while active
s.isActive(); s.id(); s.expiresAt(); s.revision();لكل طلب، دون تمرير المقيّم من دالة إلى أخرى: يحتفظ TestSessions بالجلسة الحالية لكل خيط. ولا تعتمد الحزمة على servlet؛ ويكفي مرشّح من بضعة أسطر:
public final class NanoFlagsSessionFilter implements Filter { // jakarta.servlet or javax.servlet
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {
try (TestSessions.Scope scope = TestSessions.open(((HttpServletRequest) req).getHeader(TestSessions.HEADER))) {
TestSessions.flagsFor(flags); // resolve once, before the handler runs
chain.doFilter(req, res);
}
}
}
// anywhere in the request
boolean v2 = TestSessions.flagsFor(flags).boolVariation("checkout-v2", Map.of("key", userId), false);
HttpRequest call = TestSessions.propagate(HttpRequest.newBuilder(pricingUri)).GET().build(); // the next service joins
executor.submit(TestSessions.wrap(task)); // hand the session to another thread
TestSessions.withSession(job.sessionToken(), () -> process(job)); // queues, jobs and tests| الواجهة | الوصف |
|---|---|
client.session(token[, service]) · sessionAsync(...) | تحلّ الجلسة (GET /v1/session) وتعيد SessionEvaluator؛ ويُرسل service كـ X-NanoFlags-Service (افتراضيًا: service الخاصة بالعميل). |
SessionEvaluator | دوال القراءة الخاصة بالعميل، ومعها isActive() وid() وexpiresAt() وrevision(). |
TestSessions.open(token) · withSession(token, fn) | تجعل token الجلسة الحالية لهذا الخيط (وScope من نوع AutoCloseable ويستعيد الجلسة السابقة)؛ والرمز الغائب أو المشوّه يعمل خارج أي جلسة. |
TestSessions.flagsFor(client[, service]) | مقيّم الطلب الحالي، يُحلّ مرة واحدة لكل نطاق وعميل؛ وخارج الجلسة يتصرّف كالعميل. |
currentSession() · sessionHeaders() · propagate(builder) | الرمز الحالي (أو null)؛ و{x-nanoflags-session: token} (أو فارغ)؛ وتضيف الترويسة إلى طلب java.net.http. |
TestSessions.wrap(Runnable / Callable) | تشغّل العمل على خيط آخر داخل الجلسة الحالية. |
NanoFlagsClient.SESSION_HEADER · isSessionToken(s) | "x-nanoflags-session"؛ والرمز من 1 إلى 512 محرفًا ASCII قابلًا للطباعة. |
- تُسأل الحافة مرة واحدة لكل رمز وخدمة، ويتشارك المستدعون المتزامنون الطلب نفسه، ويُخزَّن الجواب مؤقتًا حتى تنتهي الجلسة. وتُتذكَّر الرموز المجهولة 15 ثانية، وعمليات البحث الفاشلة (المبلَّغ عنها برمز الخطأ
SESSION) 3 ثوانٍ. - لا ترمي استثناءً أبدًا: الرمز الغائب أو المشوّه أو المجهول أو المنتهي أو الملغى أو غير المسموح به يعود إلى الإعداد العادي، ويتصرّف المقيّم تمامًا كالعميل. وإن انتهت الجلسة أثناء الطلب تصبح غير نشطة وتستمر التقييمات على الإعداد المنشور. ولا تغيّر نسخةٌ منشورة حديثًا جلسةً نشطة.
- تُمرَّر الجلسة المجهولة إلى الخدمات التالية مع ذلك: الخدمة التالية تقرّر بنفسها.
- تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط؛ فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل في عملية خزّنتها مؤقتًا حتى وقت انتهائها.
مزوّد OpenFeature
dependencies { implementation("io.nanoflags:nanoflags-java-openfeature:0.2.0") }import dev.openfeature.sdk.*;
import io.nanoflags.server.NanoFlagsClient;
import io.nanoflags.server.openfeature.NanoFlagsProvider;
NanoFlagsClient flags = NanoFlagsClient.create(System.getenv("NANOFLAGS_SDK_KEY"));
OpenFeatureAPI api = OpenFeatureAPI.getInstance();
api.setProviderAndWait(NanoFlagsProvider.builder(flags).closeClient(true).build());
Client client = api.getClient();
boolean on = client.getBooleanValue("new-checkout", false,
new ImmutableContext("user-42", Map.of("plan", new Value("pro"))));- للـ SDK الرسمي في جافا (
dev.openfeature:sdk1.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مع مفاتيح الأعلام التي تغيّرت. - خيارات المُنشئ:
closeClient(true)يغلق عميل NanoFlags حين يوقف OpenFeature المزوّد؛ وinitTimeout(Duration)يحدّ مدة التهيئة (10 ثوانٍ افتراضيًا).
الخيارات
| الخيار | الافتراضي | الوصف |
|---|---|---|
baseUrl(url) | https://edge.nanoflags.io | عنوان الحافة. |
service(name) | "unknown" | الاسم الذي تُبلّغ به هذه العملية. |
httpClient(HttpClient) | ينشئه الـ SDK | يستخدم ProxySelector.getDefault() (ويحترم https.proxyHost). |
pollInterval(d) · livePollInterval(d) | 30 ث · 5 د | Duration.ZERO يعطّل الاستطلاع. |
live(bool) · streaming(bool) | true | لتعطيل WebSocket أو أحداث الخادم. |
store(Store) · bootstrap(Bundle) · bootstrapJson(String) | لا شيء | انظر آخر إعداد سليم. |
verify(VerifyOptions) · withoutVerification() | مفعّل للحافة المستضافة | انظر التحقق من التوقيع. |
events(EventsOptions) | عيّنة 10 % | انظر القياس. |
requestTimeout(d) · liveConnectTimeout(d) | 10 ث · 10 ث | مهلتا طلب HTTP والاتصال عبر WebSocket. |
logger(System.Logger) | io.nanoflags.server | مستوى debug فقط. |
رموز الأخطاء
تصل أعطال الخلفية إلى onError كـ NanoFlagsException له code() (وhttpStatus() عند الحاجة): NETWORK وUNAUTHORIZED وHTTP وINVALID_BUNDLE وSTORE وCONFIG وSIGNATURE وSESSION وENGINE وENVIRONMENT_DELETED. ولا تغيّر هذه الأعطال الإعداد المستخدم، ولا يُرمى أي شيء من استدعاء قراءة. والمعاني مطابقة لـ SDK جافاسكريبت.
الإغلاق والإيقاف
Runtime.getRuntime().addShutdownHook(new Thread(flags::close));
// or scope it
try (NanoFlagsClient job = NanoFlagsClient.create(sdkKey, NanoFlagsOptions.builder().service("nightly-job").build())) {
run(job);
}- يرسل
close()القياس المنتظر (بأفضل جهد)، ويوقف كل خيوط الخلفية وينتظرها. واستدعاؤه أكثر من مرة آمن. - بعد
close()تواصل القراءات العمل على آخر إعداد، لكنه يتوقف عن التحديث فقط. ويعيدrefresh()التحقق فورًا، ويرميNanoFlagsExceptionإن فشل ذلك الطلب. - خيوط الخلفية خيوط daemon، فلا تُبقي آلة JVM حيّة.
حل المشكلات
- كل قراءة تعيد القيمة الاحتياطية. افحص
status()وlastError(). يعنيUNAUTHORIZEDأن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل. - خلف وسيط. يتبع عميل HTTP الافتراضي
ProxySelector.getDefault()، فاضبطhttps.proxyHostوhttps.proxyPort، أو مرّرHttpClientخاصًا بك. وإن حُجبت ترقية WebSocket يعرضtransport()القيمةSTREAMأوPOLL. - أخطاء بالرمز
SIGNATURE. لم تجتز الحزمة التحقق فلم تُستخدم. ومعbaseUrlمخصّص ثبّت مفاتيح تلك الحافة عبرVerifyOptions. - أخطاء بالرمز
ENVIRONMENT_DELETED. أغلقت الحافة المقبس بالرمز 4004. يتوقف العميل عن إعادة الاتصال ويُبقي آخر إعداد بحالةSTALE؛ استبدل المفتاح. - لمعرفة ما يفعله العميل. مرّر
System.Loggerعبرlogger(…)، أو فعّل سجلات debug لـio.nanoflags.server.