डिबग

डिबग()

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

debug फ़ंक्शन को केवल नियम शर्तों के अंदर ही बुलाया जा सकता है।

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

डीबग लॉगफ़ाइल प्रविष्टियाँ लॉग आउटपुट के नियम भाषा डेटा प्रकार (उदाहरण के लिए, string_value , map_value ) की पहचान करने वाली एक स्ट्रिंग द्वारा जोड़ी जाती हैं।

debug के लिए कॉल को नेस्ट किया जा सकता है।

वर्तमान में, debug सुविधा लॉगिंग स्तरों की अवधारणा का समर्थन नहीं करती है (उदाहरण के लिए, जानकारी, चेतावनी, त्रुटि)।

// 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
...