XML DOM evaluate() Method
التعريف والاستخدام
يحسب evaluate() عبارة XPath.
النحو:
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
| المُدخلات | وصف |
|---|---|
| xpathText | العبارة النصية التي يتم حساب XPath. |
| contextNode | النقاط في الوثيقة التي تتوافق مع العبارة الحسابية التي سيتم حسابها. |
| namespaceURLMapper |
الوظيفة التي تُرتبط فيها مُقابلة منسقة للأمام لاسم المُقابلة الأولي بـ URL المُقابلة الكاملة. إذا لم يكن هناك حاجة إلى هذا التحويل، فإنه null. |
| resultType |
يُحدد نوع العنصر الذي يتوقعونه كنتيجة باستخدام التحويل من XPath لفرض نوع النتيجة. القيم المحتملة لنوع result هي المعادلات الثابتة المحددة من قبل XPathResult Object. |
| result |
XPathResult Object مُتعددة الاستخدامات؛ إذا كنت ترغب في إنشاء XPathResult Object جديد، فإنه null. |
النتيجة
يعبر عن قيمة العودة لعبارة حسابية محسوبة بناءً على نقطة السياق المقدمة XPathResult Object。
يُلقي
إذا xpathText يحتوي على أخطاء نحوية، أو إذا لم يتمكن نتائج التعبير من تحويل إلى النوع المطلوب resultType، أو إذا كان التعبير يحتوي على namespaceURLMapper لا يمكن تحليل المساحة النامية، أو إذا contextNode إذا كان النوع خاطئًا أو لا يتناسب مع هذا المستند، فإن هذه الطريقة ستقوم بإلقاء استثناء.
وصف
يحسب هذا الطريقة النود المحدد للسياق ويحسب التعبير المحدد للXPath، ويقوم بتقديم XPathResult كائن، ويحدد النوع لتحديد نوع النتيجة يجب أن يكون. Document.createExpression() لتحويل التعبير إلى XPathExpression كائن، ثم استخدم طريقة evaluate() في XPathExpression.
IE لا يدعم هذه API. أنظر Node.selectNodes() و Node.selectSingleNode() للتعرف على طريقة بديلة محددة لـ IE.
