التثبيت حسب المنصة

أي موقع إلكتروني

التثبيت npm install @blipit/browser

حجم SDK المتصفح من Blipit هو 7 كيلوبايت. يلتقط الأخطاء غير الملتقطة ورفض الـ promise غير المعالج والطلبات الفاشلة، ويحتفظ بالنقرات والطلبات التي أدت إلى كل خطأ، ويسجّل مؤشرات الويب الحيوية، ويمكنه تسجيل إعادة تشغيل الجلسة عند وقوع خطأ. ثبّته من npm في تطبيق محزوم، أو ضع وسم script واحدًا في أي صفحة.

1عبر npm

استدعِ init مرة واحدة، قبل تشغيل بقية كودك. استخدم المفتاح العام.

sh
npm install @blipit/browser
js
import * as Blipit from "@blipit/browser";

Blipit.init({
  key: "<public key>",
  environment: "production",
  release: "2026.09.28",
  replay: { onErrorSampleRate: 1 },
});

2بدون أداة حزم: وسم script واحد

الصق هذا في <head> لكل صفحة، أو في خانة الكود المخصص في منصتك.

html
<script src="https://blipit.io/sdk/blipit.js"></script>
<script>
  Blipit.init({ key: "<public key>", environment: "production", release: "2026.09.28", replay: { onErrorSampleRate: 1 } });
</script>

3أخبر Blipit من هو المستخدم (اختياري)

بعد تسجيل الدخول، أرفق المستخدم لتُظهر المشكلات من تأثر ويمكن العثور على إعادات التشغيل حسب المستخدم.

js
Blipit.setUser({ id: "42", email: "ana@example.com" });

4تحقق من أنه يعمل

في console المتصفح على موقعك، شغّل السطر أدناه. افتح المشكلات في app.blipit.io. يظهر الحدث الأول خلال بضع ثوانٍ، مجمّعًا في مشكلة، ويتلقى المسؤولون بريدًا إلكترونيًا.

js
Blipit.captureMessage("Hello from " + location.host, "info");

من المفيد معرفته

  • الخيارات: sampleRate (من 0 إلى 1)، وignoreErrors (سلاسل نصية أو أنماط)، وbeforeSend لإسقاط حدث أو تعديله، وmaxBreadcrumbs، وwebVitals (مفعّل افتراضيًا)، وautoSessionTracking لمعدلات الخلو من الأعطال (يحتاج إلى release).
  • توجد إصدارات script المثبّتة على blipit.io/sdk/0.2.0/blipit.js إذا أردت التحكم في الترقيات.
  • سياسة أمان المحتوى (CSP): اسمح بـ https://in.blipit.io في connect-src، وبـ https://blipit.io في script-src إذا كنت تستخدم وسم script.
  • هل تستخدم Sentry SDK في المتصفح بالفعل؟ يعمل دون تغيير: اضبط DSN على https://<public key>@in.blipit.io/<project id>.

هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح وDSN الدقيق لكل مشروع موجودة تحت مفاتيح API في app.blipit.io.