مетод evaluate() XML DOM
تعریف و استفاده
مетод evaluate() یک عبارت XPath را محاسبه می‌کند.
قوانین:
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
| پارامتر | وصف |
|---|---|
| xpathText | موضوع عبارت XPath مورد محاسبه. |
| contextNode | در مستند، موضوعات مربوط به عبارت محاسبه شده. |
| namespaceURLMapper |
یک تابع برای نقشه‌گذاری یک پیشوند نام‌گذاری شده به یک URL نام‌گذاری شده کامل است. اگر نیازی به این نقشه‌گذاری نیست، null است. |
| resultType |
نوع موضوع مورد انتظار به عنوان نتیجه را مشخص می‌کند، از تبدیل XPath برای اجباراً کردن نوع نتیجه استفاده می‌شود. ممکنه‌ترین مقادیر نوع result نوع موضوع XPathResult تعریف شده است. |
| result |
یک موضوع XPathResult قابل استفاده مجدد اگر می‌خواهید یک موضوع XPathResult جدید ایجاد کنید، null است. |
مقدار بازگشتی
نشان‌دهنده یک موضوع XPathResult。
پرتاب
اگر xpathText شامل خطای گرامری است یا اگر نتایج عبارت نمی‌تواند به نوع مورد انتظار تبدیل شود. resultType، یا اگر عبارت شامل namespaceURLMapper فضای نام قابل درک نیست، یا اگر contextNode با نوع اشتباه یا اگر این موضوع با این مستند مرتبط نیست، این روش یک استثنا پرتاب می‌کند.
وصف
این روش بر اساس گزینه‌های داده شده به Node برای محاسبه عبارت XPath مشخص شده و یک موضوع XPathResult برمی‌گرداند که نوع آن برای تعیین نوع نتیجه باید چیست تعیین می‌کند. اگر بخواهید یک عبارت را چندین بار محاسبه کنید، از Document.createExpression() برای ترجمه یک عبارت به یک موضوع XPathExpression، سپس از روش evaluate() XPathExpression استفاده کنید.
IE این API را پشتیبانی نمی‌کند. مطالعه کنید Node.selectNodes() و Node.selectSingleNode() برای یک روش جایگزین خاص به IE.
