नाम स्थान: डीबग

डीबग करें

डीबग()

सुरक्षा नियमों की भाषा को प्रिंट करने वाला बेसिक डीबग फ़ंक्शन ऑब्जेक्ट, वैरिएबल, और स्टेटमेंट के नतीजे असल में होते हैं 'सुरक्षा नियम' इंजन करता है. debug के आउटपुट इस सूची में लिखे जाते हैं Firestore-debug.log.

debug फ़ंक्शन को सिर्फ़ 'नियम' सुविधा के अंदर कॉल किया जा सकता है शर्तें.

debug फ़ंक्शन ब्लॉक को सिर्फ़ सुरक्षा नियम इंजन इसमें लागू करता है Firestore एम्युलेटर, Firebase एम्युलेटर सुइट का हिस्सा है. डीबग फ़ंक्शन का प्रोडक्शन पर कोई असर नहीं पड़ता.

डीबग लॉगफ़ाइल की एंट्री को नियमों की पहचान करने वाली स्ट्रिंग से पहले जोड़ा जाता है लॉग आउटपुट की भाषा के लिए डेटा टाइप (उदाहरण के लिए, 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
...