الفرق بين المراجعتين لصفحة: «Python/urllib/error»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الوحدة <code>urllib.error()</code> في بايثون}}</noinclude> تعرّف الوحدة urllib.error الأصناف الخاص...' |
|||
| (4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الوحدة <code>urllib. | <noinclude>{{DISPLAYTITLE:الوحدة <code>urllib.error</code> في بايثون}}</noinclude> | ||
تعرّف الوحدة urllib.error الأصناف الخاصة بالاستثناءات التي تُطلقها الوحدة urllib.request. | تعرّف الوحدة <code>urllib.error</code> الأصناف الخاصة بالاستثناءات التي تُطلقها الوحدة <code>[[Python/urllib/request|urllib.request]]</code>. | ||
الصنف الأساسي في هذه الوحدة هو URLError. | الصنف الأساسي في هذه الوحدة هو <code>URLError</code>. | ||
تطلق الوحدة urllib.error الاستثناءات التالية: | تطلق الوحدة <code>urllib.error</code> الاستثناءات التالية: | ||
== الاستثناء urllib.error.URLError == | == الاستثناء <code>urllib.error.URLError</code> == | ||
تُطلق أصناف المعالجة هذا الاستثناء (أو الاستثناءات المشتقة منه) عند وقوعها في مشكلة معيّنة. هذا الاستثناء هو صنف متفرّع من الاستثناء OSError. | تُطلق أصناف المعالجة هذا الاستثناء (أو الاستثناءات المشتقة منه) عند وقوعها في مشكلة معيّنة. هذا الاستثناء هو صنف متفرّع من الاستثناء <code>OSError</code>. | ||
=== reason === | === <code>reason</code> === | ||
سبب حدوث هذا الخطأ. يمكن أن تكون رسالة على هيئة سلسلة نصية أو نسخة من استثناء آخر. | سبب حدوث هذا الخطأ. يمكن أن تكون رسالة على هيئة سلسلة نصية أو نسخة من استثناء آخر. | ||
'''ملاحظة:''' أصبح <code>URLError</code> صنفًا متفرّعًا من الصنف <code>OSError</code> عوضًا عن <code>IOError</code> في الإصدار 3.3 من بايثون. | |||
أصبح URLError صنفًا متفرّعًا من الصنف OSError عوضًا عن IOError في الإصدار 3.3 من بايثون. | |||
== الاستثناء urllib.error.HTTPError == | == الاستثناء <code>urllib.error.HTTPError</code> == | ||
على الرغم من كون HTTPError استثناءً (متفرّعًا من الصنف URLError) إلا أنّ بالإمكان استخدامه كقيمة معادة شبيهة بالملفات (كتلك المعادة بواسطة الدالة urlopen()). يمكن الاستفادة من هذا السلوك عند معالجة أخطاء HTTP الخارجية exotic مثل طلبات الاستيثاق. | على الرغم من كون <code>HTTPError</code> استثناءً (متفرّعًا من الصنف <code>URLError</code>) إلا أنّ بالإمكان استخدامه كقيمة معادة شبيهة بالملفات (كتلك المعادة بواسطة الدالة <code>[[Python/urllib/request/urlopen|urlopen()]]</code>). يمكن الاستفادة من هذا السلوك عند معالجة أخطاء HTTP الخارجية exotic مثل طلبات الاستيثاق. | ||
=== code === | === <code>code</code> === | ||
شيفرة حالة HTTP حسب ما هو معرّف في المعيار RFC 2616. ترتبط هذه القيمة العددية بالقيمة الموجودة في قاموس الشيفرات وكما هو موجود في http.server.BaseHTTPRequestHandler.responses. | شيفرة حالة HTTP حسب ما هو معرّف في المعيار [[rfc:2616.html|RFC 2616]]. ترتبط هذه القيمة العددية بالقيمة الموجودة في قاموس الشيفرات وكما هو موجود في <code>http.server.BaseHTTPRequestHandler.responses</code>. | ||
=== reason === | === <code>reason</code> === | ||
عادة ما تكون سلسلة نصية توضّح سبب حدوث هذا الخطأ. | عادة ما تكون سلسلة نصية توضّح سبب حدوث هذا الخطأ. | ||
=== headers === | === <code>headers</code> === | ||
ترويسات استجابة HTTP | ترويسات استجابة HTTP للطلب الذي تسبب في حدوث الخطأ <code>HTTPError</code>. | ||
ملاحظة: هذا الاستثناء جديد في الإصدار 3.4 من بايثون. | ملاحظة: هذا الاستثناء جديد في الإصدار 3.4 من بايثون. | ||
== الاستثناء urllib.error. | == الاستثناء <code>urllib.error.ContentTooShortError(msg, content)</code> == | ||
يُطلق هذا الاستثناء عندما تكتشف الدالة urlretrieve() أن كمية البيانات المحمّلة أقل من الكمية المتوقعة (المعطاة بواسطة الترويسة Content-Length). تخزّن الخاصية content البيانات المحمّلة (والتي يفترض أن تكون مقطوعة truncated). | يُطلق هذا الاستثناء عندما تكتشف الدالة <code>[[Python/urllib/request/urlretrieve|urlretrieve()]]</code> أن كمية البيانات المحمّلة أقل من الكمية المتوقعة (المعطاة بواسطة الترويسة <code>Content-Length</code>). تخزّن الخاصية <code>content</code> البيانات المحمّلة (والتي يفترض أن تكون مقطوعة truncated). | ||
== انظر أيضًا == | |||
الوحدة <code>[[Python/urllib/request|urllib.request]]</code>: تقدّم وحدة <code>urllib.request</code> عددًا من الدوال والأصناف التي تساعد في فتح عناوين URL (HTTP في الغالب) لاستخدامها في عمليات مختلفة مثل الاستيثاق البسيط وإعادة التوجيه والتعامل مع الكعكات cookies وغيرها. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 18:30، 6 فبراير 2019
تعرّف الوحدة urllib.error الأصناف الخاصة بالاستثناءات التي تُطلقها الوحدة urllib.request.
الصنف الأساسي في هذه الوحدة هو URLError.
تطلق الوحدة urllib.error الاستثناءات التالية:
الاستثناء urllib.error.URLError
تُطلق أصناف المعالجة هذا الاستثناء (أو الاستثناءات المشتقة منه) عند وقوعها في مشكلة معيّنة. هذا الاستثناء هو صنف متفرّع من الاستثناء OSError.
reason
سبب حدوث هذا الخطأ. يمكن أن تكون رسالة على هيئة سلسلة نصية أو نسخة من استثناء آخر.
ملاحظة: أصبح URLError صنفًا متفرّعًا من الصنف OSError عوضًا عن IOError في الإصدار 3.3 من بايثون.
الاستثناء urllib.error.HTTPError
على الرغم من كون HTTPError استثناءً (متفرّعًا من الصنف URLError) إلا أنّ بالإمكان استخدامه كقيمة معادة شبيهة بالملفات (كتلك المعادة بواسطة الدالة urlopen()). يمكن الاستفادة من هذا السلوك عند معالجة أخطاء HTTP الخارجية exotic مثل طلبات الاستيثاق.
code
شيفرة حالة HTTP حسب ما هو معرّف في المعيار RFC 2616. ترتبط هذه القيمة العددية بالقيمة الموجودة في قاموس الشيفرات وكما هو موجود في http.server.BaseHTTPRequestHandler.responses.
reason
عادة ما تكون سلسلة نصية توضّح سبب حدوث هذا الخطأ.
headers
ترويسات استجابة HTTP للطلب الذي تسبب في حدوث الخطأ HTTPError.
ملاحظة: هذا الاستثناء جديد في الإصدار 3.4 من بايثون.
الاستثناء urllib.error.ContentTooShortError(msg, content)
يُطلق هذا الاستثناء عندما تكتشف الدالة urlretrieve() أن كمية البيانات المحمّلة أقل من الكمية المتوقعة (المعطاة بواسطة الترويسة Content-Length). تخزّن الخاصية content البيانات المحمّلة (والتي يفترض أن تكون مقطوعة truncated).
انظر أيضًا
الوحدة urllib.request: تقدّم وحدة urllib.request عددًا من الدوال والأصناف التي تساعد في فتح عناوين URL (HTTP في الغالب) لاستخدامها في عمليات مختلفة مثل الاستيثاق البسيط وإعادة التوجيه والتعامل مع الكعكات cookies وغيرها.