לנפות

לנפות()

פונקציית ניפוי באגים בסיסית שמדפיסה אובייקטים של שפת כללי אבטחה, משתנים ותוצאות הצהרות בזמן שהם מוערכים על ידי מנוע כללי האבטחה. הפלטים של debug נכתבים ל-firestore-debug.log.

ניתן לקרוא לפונקציית debug רק בתוך תנאי כללים.

בלוקים של ניפוי debug מבוצעים רק על ידי מנוע כללי האבטחה באמולטור Firestore, חלק מחבילת Firebase Emulator Suite. לפונקציית ניפוי הבאגים אין השפעה בייצור.

ערכי קובץ יומן ניפוי באגים מוצמדים למחרוזת המזהה את סוג הנתונים של שפת הכללים של פלט היומן (לדוגמה, string_value , map_value ).

ניתן לקנן קריאות debug .

נכון לעכשיו, תכונת debug אינה תומכת בקונספט של רמות רישום (לדוגמה, INFO, WARN, ERROR).

// firestore.rules
// Nested debug calls in the following match block....
match /carts/{cartID} {
  allow create: if request.auth != null && request.auth.uid == request.resource.data.ownerUID;
    allow read, update, delete: if
      debug(
        debug(request.auth.uid) == debug(resource.data.ownerUID)
      );
  }
...

// firestore-debug.log
// ...produce logfile output like the following.
string_value: "alice" // for debug(request.auth.uid)

string_value: "alice" // for debug(resource.data.ownerUID)

bool_value: true      // for the outermost enclosing debug() call
...