الفرق بين المراجعتين لصفحة: «Python/urllib/request/Request»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>urllib.request.Request</code> في بايثون}}</noinclude> يعدّ هذا الصنف تجريدًا abstraction لط...' |
|||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 7: | سطر 7: | ||
urllib.request.Request(url, data=None, headers={}, origin_req_host=None, unverifiable=False, method=None) | urllib.request.Request(url, data=None, headers={}, origin_req_host=None, unverifiable=False, method=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== url === | === <code>url</code> === | ||
يجب أن يكون سلسلة نصية تحتوي على عنوان URL صالح للاستخدام. | يجب أن يكون سلسلة نصية تحتوي على عنوان URL صالح للاستخدام. | ||
=== data === | === <code>data</code> === | ||
يجب أن يكون كائنًا يحدّد المعلومات الإضافية التي ستُرسل إلى المخدّم، أو يحمل القيمة None في حال انتفاء الحاجة إلى إرسال مثل هذه المعلومات. يستخدم هذا المعامل من قبل طلبات HTTP فقط في الوقت الحاضر. أنواع الكائنات المدعومة هي كائنات | يجب أن يكون كائنًا يحدّد المعلومات الإضافية التي ستُرسل إلى المخدّم، أو يحمل القيمة None في حال انتفاء الحاجة إلى إرسال مثل هذه المعلومات. يستخدم هذا المعامل من قبل طلبات HTTP فقط في الوقت الحاضر. أنواع الكائنات المدعومة هي [[PHP|كائنات bytes]]، والكائنات الشبيهة بالملفات file-like objects، والكائنات القابلة للتكرار iterables. | ||
في حال عدم تقديم الحقلين Content-Length و Transfer-Encoding فإنّ الصنف HTTPHandler سيعين قيمة | في حال عدم تقديم الحقلين <code>Content-Length</code> و <code>Transfer-Encoding</code> فإنّ الصنف <code>HTTPHandler</code> سيعين قيمة لهذين الحقلين في الترويسة بالاعتماد على طبيعة البيانات المعطاة في هذا المعامل. تستخدم الترويسة <code>Content-Length</code> لإرسال كائنات البايتات، أما الترويسة <code>Transfer-Encoding: chunked</code> فستُستخدم لإرسال الملفات والكائنات القابلة للتكرار (وذلك بحسب ما هو محدّد في المعيار RFC 7230 الفصل 3.3.1). | ||
في حال كانت طريقة طلب HTTP هي | في حال كانت طريقة طلب <code>HTTP</code> هي <code>POST</code>، فإنّ قيمة <code>data</code> يجب أن تكون صِوانًا buffer بالصيغة المعيارية <code>application/x-www-form-urlencoded</code>. تأخذ الدالة <code>[[Python/urllib/parse/urlencode|urllib.parse.urlencode()]]</code> كائن ربط أو تسلسلًا من صفّ ثنائي وتعيد سلسلة نصية بترميز ASCII بهذه الصيغة. يجب ترميز هذه السلسلة النصية إلى بايتات قبل استخدامها كقيمة للمعامل data. | ||
=== headers === | === <code>headers</code> === | ||
يجب أن يكون قاموسًا، وسيعامل كما لو أنّه قد استدعيت الدالة add_header() مع كل مفتاح وقيمة كوسائط لهذه الدالة. يستخدم هذا المعامل غالبًا لانتحال spoof قيمة الترويسة User- | يجب أن يكون قاموسًا، وسيعامل كما لو أنّه قد استدعيت الدالة add_header() مع كل مفتاح وقيمة كوسائط لهذه الدالة. يستخدم هذا المعامل غالبًا لانتحال spoof قيمة الترويسة <code>User-Agent</code>، والتي تستخدم بواسطة المتصفح لتمييز نفسه. تجيز بعض مخدّمات HTTP الطلبات القادمة من المتصفّحات المعروفة فقط وذلك بخلاف السكربتات. | ||
يعرّف المتصفح Mozilla Firefox نفسه بالسلسلة النصية "Mozilla/5.0(X11; U; Linux i686) Gecko/20071127 Firefox/2.0.0.11" في حين يعرّف وكيل المستخدم user agent الافتراضي في وحدة urllib نفسه بالسلسلة النصية "Python-urllib/2.6" (في الإصدار 2.6 من بايثون). | يعرّف المتصفح Mozilla Firefox نفسه بالسلسلة النصية <code>"Mozilla/5.0(X11; U; Linux i686) Gecko/20071127 Firefox/2.0.0.11"</code> في حين يعرّف وكيل المستخدم user agent الافتراضي في وحدة <code>urllib</code> نفسه بالسلسلة النصية <code>"Python-urllib/2.6"</code> (في الإصدار 2.6 من بايثون). | ||
يجب تضمين ترويسة Content-Type ملائمة عند استخدام المعامل data. وفي حال عدم تزويد الطلب بهذه الترويسة وكانت قيمة المعامل data هي None فإنّ الترويسة Content-Type: application/x-www/form/urlencoded ستضاف إلى الطلب افتراضيًا. | يجب تضمين ترويسة <code>Content-Type</code> ملائمة عند استخدام المعامل data. وفي حال عدم تزويد الطلب بهذه الترويسة وكانت قيمة المعامل <code>data</code> هي <code>None</code> فإنّ الترويسة <code>Content-Type: application/x-www/form/urlencoded</code> ستضاف إلى الطلب افتراضيًا. | ||
يُستخدم المعاملان الأخيران فقط لمعالجة كعكات HTTP من الطرف الثالث بطريقة صحيحة: | يُستخدم المعاملان الأخيران فقط لمعالجة كعكات HTTP من الطرف الثالث بطريقة صحيحة: | ||
=== origin_req_host === | === <code>origin_req_host</code> === | ||
يجب أن يكون مضيف الطلب الخاصّ بالعملية الأصلية origin transaction، وكما هو معرّف في المعيار RFC 2965. يأخذ هذا المعامل القيمة الافتراضية http.cookiejar.request_host(self). يتضمّن هذا المعامل اسم المضيف أو عنوان IP للطلب الأصلي المُرسل من قبل المستخدم. فعلى سبيل المثال، إن كان الطلب لصورة في مستند HTML، يجب أن يكون هذا المعامل مضيف الطلب الخاص بطلب الصفحة التي تحتوي هذه الصورة. | يجب أن يكون مضيف الطلب الخاصّ بالعملية الأصلية origin transaction، وكما هو معرّف في المعيار RFC 2965. يأخذ هذا المعامل القيمة الافتراضية <code>http.cookiejar.request_host(self)</code>. يتضمّن هذا المعامل اسم المضيف أو عنوان IP للطلب الأصلي المُرسل من قبل المستخدم. فعلى سبيل المثال، إن كان الطلب لصورة في مستند HTML، يجب أن يكون هذا المعامل مضيف الطلب الخاص بطلب الصفحة التي تحتوي هذه الصورة. | ||
=== unverifiable === | === <code>unverifiable</code> === | ||
يجب أن يحدّد هذا المعامل ما إذا كان الطلب غير قابلٍ للتحقق منه | يجب أن يحدّد هذا المعامل ما إذا كان الطلب غير قابلٍ للتحقق منه <code>unverifiable</code>، وكما هو معرف في المعيار RFC 2965. يأخذ المعامل القيمة الافتراضية <code>False</code>. يُقصد بالطلب غير القابل للتحقق منه الطلب الذي يمتلك عنوان URL لا يمكن للمستخدم التثبت منه. فعلى سبيل المثال إن كان الطلب لصورة في ملف HTML ولم يكن المستخدم قادرًا على التثبت من عملية جلب الصورة التلقائية، يجب أن يأخذ هذا المعامل قيمة صحيحة. | ||
=== method === | === <code>method</code> === | ||
يجب أن يكون سلسلة نصية تشير إلى طريقة HTTP التي ستُستخدم (مثل: 'HEAD'). تُخزّن قيمة هذا المعامل -إن كانت متوفّرة- في الخاصية method وتُستخدم بواسطة التابع get_method(). يحمل هذا المعامل القيمة الافتراضية 'GET' إن كانت قيمة المعامل data هي | يجب أن يكون سلسلة نصية تشير إلى طريقة HTTP التي ستُستخدم (مثل: <code>'HEAD'</code>). تُخزّن قيمة هذا المعامل -إن كانت متوفّرة- في الخاصية <code>method</code> وتُستخدم بواسطة التابع <code>get_method()</code>. يحمل هذا المعامل القيمة الافتراضية <code>'GET'</code> إن كانت قيمة المعامل <code>data</code> هي <code>None</code>، والقيمة الافتراضية <code>'POST'</code> فيما عدا ذلك. يمكن للأصناف المتفرّعة أن تحدّد قيمة افتراضية أخرى وذلك بتعيين قيمة للخاصية <code>method</code> في الصنف المتفرّع ذاته. | ||
'''ملاحظات: ''' | '''ملاحظات: ''' | ||
* لن يعمل الطلب بصورة صحيحة إن لم يكن كائن البيانات قادرًا على توصيل محتواه لأكثر من مرّة (مثل ملفّ أو كائن iterable يُنتج المحتوى مرّة واحدة فقط) ويُعاد إرسال الطلب في حالة إعادة التوجيه أو عند الاستيثاق. تُرسل قيمة المعامل data إلى مخدّم HTTP بعد الترويسات مباشرة. لا يوجد دعم لترويسة "100-continue" في المكتبة. | * لن يعمل الطلب بصورة صحيحة إن لم يكن كائن البيانات قادرًا على توصيل محتواه لأكثر من مرّة (مثل ملفّ أو كائن iterable يُنتج المحتوى مرّة واحدة فقط) ويُعاد إرسال الطلب في حالة إعادة التوجيه أو عند الاستيثاق. تُرسل قيمة المعامل <code>data</code> إلى مخدّم HTTP بعد الترويسات مباشرة. لا يوجد دعم لترويسة <code>"100-continue"</code> في المكتبة. | ||
* أضيف الوسيط Request.method إلى الصنف Request في الإصدار 3.3 من بايثون. | * أضيف الوسيط <code>Request.method</code> إلى الصنف <code>Request</code> في الإصدار 3.3 من بايثون. | ||
* أصبح بالإمكان تحديد القيمة الافتراضية للوسيط Request.method ضمن الصنف نفسه. | * أصبح بالإمكان تحديد القيمة الافتراضية للوسيط <code>Request.method</code> ضمن الصنف نفسه. | ||
* في الإصدار 3.6 من بايثون لا يُطلق أي خطأ إن لم تُزوّد الترويسة Content-Length ولم تكن قيمة المعامل data هي None أو كائن بايتات. استخدم ترميز النقل المقطّع chunked transfer encoding عوضًا عن ذلك. | * في الإصدار 3.6 من بايثون لا يُطلق أي خطأ إن لم تُزوّد الترويسة <code>Content-Length</code> ولم تكن قيمة المعامل <code>data</code> هي <code>None</code> أو كائن بايتات. استخدم ترميز النقل المقطّع chunked transfer encoding عوضًا عن ذلك. | ||
== كائنات <code>Request</code>== | |||
تصف التوابع التالية الواجهة العامة لكائنات <code>Request</code> ويمكن إعادة تعريف هذه التوابع في الأصناف المتفرّعة عن هذا الصنف. تقدّم هذه الكائنات كذلك مجموعة من الخصائص العامة التي يمكن استخدامها بواسطة العميل لتعقّب الطلب المفسّر. | |||
===الخاصية <code>Request.full_url</code>=== | |||
عنوان <code>URL</code> الأصلي والممرّر إلى الدالة البانية. | |||
يمكن تعيين قيمة للخاصية <code>Request.full_url</code> إضافة إلى قراءة القيمة وحذفها. تعيد عملية قراءة القيمة عنوان الطلب الأصلي مع القطعة fragment إن كانت موجودة. | |||
===الخاصية <code>Request.type</code>=== | |||
مخطط URI. | |||
===الخاصية <code>Request.host</code>=== | |||
صلاحية URI، عادة تكون مضيفًا، ولكن يمكن أن يتضمّن منفذًا مفصولًا عن المضيف بنقطتين رأسيتين. | |||
===الخاصية <code>Request.origin_req_host</code>=== | |||
المضيف الأصلي للطلب، من دون المنفذ. | |||
===الخاصية <code>Request.selector</code>=== | |||
مسار URI. إن استخدم كائن <code>Request</code> وسيطًا، فإنّ المنتقي سيكون عنوان URL الكامل الذي مُرِّر إلى الوسيط. | |||
===الخاصية <code>Request.data</code>=== | |||
متن الطلب، أو القيمة None في حال عدم تعيينه. | |||
'''ملاحظة:''' في الإصدار 3.4 من بايثون يؤدي تغيير قيمة <code>Request.data</code> إلى حذف الترويسة <code>"Content-Length"</code> إن كانت معيّنة أو محسوبة في السابق. | |||
===الخاصية <code>Request.unverifiable</code>=== | |||
قيمة منطقية تحدّد ما إذا كان الطلب غير قابل للتوثيق unverifiable كما هو معرّف في المعيار RFC 2965. | |||
===الخاصية <code>Request.method</code>=== | |||
تحدّد هذه الخاصية الطريقة المتّبعة لإرسال طلب HTTP. القيمة الافتراضية لهذه الخاصية هي <code>None</code>، والتي تعني أنّ التابع <code>get_method()</code> سيؤدي عملها بصورة طبيعية. يمكن تعيين قيمة هذه الخاصية (وإعادة تعريف طريقة العمل الافتراضية للتابع <code>get_method()</code>) إمّا بتقديم قيمة افتراضية عن طريق تعيينها على مستوى الصنف في الأصناف المتفرّعة من الصنف <code>Request</code>، أو بتمرير القيمة إلى الدالة البانية للصنف <code>Request</code> عبر الوسيط <code>method</code>. | |||
'''ملاحظات:''' | |||
*هذه الخاصية جديدة في الإصدار 3.3 من بايثون. | |||
*في الإصدار 3.4 من بايثون أصبح بالإمكان تعيين قيمة افتراضية في الصنف الفرعي، أما في الإصدارات السابقة فقد كانت الطريقة الوحيدة هي تعيين القيمة في الدالة البانية. | |||
=== التابع <code>[[Python/urllib/request/Request/get method|Request.get_method()]]</code> === | |||
يعيد التابع سلسلة نصية تحدّد الطريقة المتّبعة في إرسال طلب HTTP. | |||
=== التابع <code>[[Python/urllib/request/Request/add header|Request.add_header()]]</code> === | |||
يضيف التابع ترويسة جديدة إلى الطلب. | |||
=== التابع <code>[[Python/urllib/request/Request/add unredirected header|Request.add_unredirected_header()]]</code> === | |||
يضيف التابع ترويسة لن تُضاف إلى الطلب المعاد توجيهه. | |||
=== التابع <code>[[Python/urllib/request/Request/has header|Request.has_header()]]</code> === | |||
يتحقّق التابع من امتلاك نسخة الكائن لترويسة مسمّاة (يتفحّص التابع الطلبات العادية وغير المعاد توجيهها). | |||
=== التابع <code>[[Python/urllib/request/Request/remove header|Request.remove_header()]]</code> === | |||
يحذف التابع الترويسة المسمّاة من نسخة الكائن (من الترويسات العادية وغير المعاد توجيهها). | |||
'''ملاحظة:''' هذا التابع جديد في الإصدار 3.4 من بايثون. | |||
=== التابع <code>[[Python/urllib/request/Request/get full url|Request.get_full_url()]]</code> === | |||
يعيد التابع عنوان URL المعطى في الدالة البانية للصنف. | |||
'''ملاحظة:''' في الإصدار 3.4 من بايثون، يعيد التابع قيمة الخاصية <code>Request.full_url</code>. | |||
=== التابع <code>[[Python/urllib/request/Request/set proxy|Request.set_proxy()]]</code> === | |||
يحضِّر التابع الطلب عن طريق الاتصال بمخدّم وسيط proxy server. | |||
=== التابع <code>[[Python/urllib/request/Request/get header|Request.get_header()]]</code> === | |||
يعيد التابع قيمة الترويسة المعطاة. | |||
=== التابع <code>[[Python/urllib/request/Request/get header items|Request.header_items()]]</code> === | |||
يعيد التابع الترويسات في كائن Request على هيئة [[Python/list|قائمة]] من [[Python/tuples|صفوف]] بهيئة (اسم الترويسة، قيمة الترويسة). | |||
'''ملاحظة:''' كانت التوابع <code>add_data</code> ،<code>has_data</code> ،<code>get_data</code> ،<code>get_type</code> ،<code>get_host</code> ،<code>get_selector</code> ،<code>get_origin_req_host</code> ،<code>is_unverifiable</code> مهملة في الإصدار 3.3 من بايثون، وقد حذفت في الإصدار 3.4. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 04:44، 28 يناير 2019
يعدّ هذا الصنف تجريدًا abstraction لطلب URL.
البنية العامة
urllib.request.Request(url, data=None, headers={}, origin_req_host=None, unverifiable=False, method=None)
المعاملات
url
يجب أن يكون سلسلة نصية تحتوي على عنوان URL صالح للاستخدام.
data
يجب أن يكون كائنًا يحدّد المعلومات الإضافية التي ستُرسل إلى المخدّم، أو يحمل القيمة None في حال انتفاء الحاجة إلى إرسال مثل هذه المعلومات. يستخدم هذا المعامل من قبل طلبات HTTP فقط في الوقت الحاضر. أنواع الكائنات المدعومة هي كائنات bytes، والكائنات الشبيهة بالملفات file-like objects، والكائنات القابلة للتكرار iterables.
في حال عدم تقديم الحقلين Content-Length و Transfer-Encoding فإنّ الصنف HTTPHandler سيعين قيمة لهذين الحقلين في الترويسة بالاعتماد على طبيعة البيانات المعطاة في هذا المعامل. تستخدم الترويسة Content-Length لإرسال كائنات البايتات، أما الترويسة Transfer-Encoding: chunked فستُستخدم لإرسال الملفات والكائنات القابلة للتكرار (وذلك بحسب ما هو محدّد في المعيار RFC 7230 الفصل 3.3.1).
في حال كانت طريقة طلب HTTP هي POST، فإنّ قيمة data يجب أن تكون صِوانًا buffer بالصيغة المعيارية application/x-www-form-urlencoded. تأخذ الدالة urllib.parse.urlencode() كائن ربط أو تسلسلًا من صفّ ثنائي وتعيد سلسلة نصية بترميز ASCII بهذه الصيغة. يجب ترميز هذه السلسلة النصية إلى بايتات قبل استخدامها كقيمة للمعامل data.
headers
يجب أن يكون قاموسًا، وسيعامل كما لو أنّه قد استدعيت الدالة add_header() مع كل مفتاح وقيمة كوسائط لهذه الدالة. يستخدم هذا المعامل غالبًا لانتحال spoof قيمة الترويسة User-Agent، والتي تستخدم بواسطة المتصفح لتمييز نفسه. تجيز بعض مخدّمات HTTP الطلبات القادمة من المتصفّحات المعروفة فقط وذلك بخلاف السكربتات.
يعرّف المتصفح Mozilla Firefox نفسه بالسلسلة النصية "Mozilla/5.0(X11; U; Linux i686) Gecko/20071127 Firefox/2.0.0.11" في حين يعرّف وكيل المستخدم user agent الافتراضي في وحدة urllib نفسه بالسلسلة النصية "Python-urllib/2.6" (في الإصدار 2.6 من بايثون).
يجب تضمين ترويسة Content-Type ملائمة عند استخدام المعامل data. وفي حال عدم تزويد الطلب بهذه الترويسة وكانت قيمة المعامل data هي None فإنّ الترويسة Content-Type: application/x-www/form/urlencoded ستضاف إلى الطلب افتراضيًا.
يُستخدم المعاملان الأخيران فقط لمعالجة كعكات HTTP من الطرف الثالث بطريقة صحيحة:
origin_req_host
يجب أن يكون مضيف الطلب الخاصّ بالعملية الأصلية origin transaction، وكما هو معرّف في المعيار RFC 2965. يأخذ هذا المعامل القيمة الافتراضية http.cookiejar.request_host(self). يتضمّن هذا المعامل اسم المضيف أو عنوان IP للطلب الأصلي المُرسل من قبل المستخدم. فعلى سبيل المثال، إن كان الطلب لصورة في مستند HTML، يجب أن يكون هذا المعامل مضيف الطلب الخاص بطلب الصفحة التي تحتوي هذه الصورة.
unverifiable
يجب أن يحدّد هذا المعامل ما إذا كان الطلب غير قابلٍ للتحقق منه unverifiable، وكما هو معرف في المعيار RFC 2965. يأخذ المعامل القيمة الافتراضية False. يُقصد بالطلب غير القابل للتحقق منه الطلب الذي يمتلك عنوان URL لا يمكن للمستخدم التثبت منه. فعلى سبيل المثال إن كان الطلب لصورة في ملف HTML ولم يكن المستخدم قادرًا على التثبت من عملية جلب الصورة التلقائية، يجب أن يأخذ هذا المعامل قيمة صحيحة.
method
يجب أن يكون سلسلة نصية تشير إلى طريقة HTTP التي ستُستخدم (مثل: 'HEAD'). تُخزّن قيمة هذا المعامل -إن كانت متوفّرة- في الخاصية method وتُستخدم بواسطة التابع get_method(). يحمل هذا المعامل القيمة الافتراضية 'GET' إن كانت قيمة المعامل data هي None، والقيمة الافتراضية 'POST' فيما عدا ذلك. يمكن للأصناف المتفرّعة أن تحدّد قيمة افتراضية أخرى وذلك بتعيين قيمة للخاصية method في الصنف المتفرّع ذاته.
ملاحظات:
- لن يعمل الطلب بصورة صحيحة إن لم يكن كائن البيانات قادرًا على توصيل محتواه لأكثر من مرّة (مثل ملفّ أو كائن iterable يُنتج المحتوى مرّة واحدة فقط) ويُعاد إرسال الطلب في حالة إعادة التوجيه أو عند الاستيثاق. تُرسل قيمة المعامل
dataإلى مخدّم HTTP بعد الترويسات مباشرة. لا يوجد دعم لترويسة"100-continue"في المكتبة. - أضيف الوسيط
Request.methodإلى الصنفRequestفي الإصدار 3.3 من بايثون. - أصبح بالإمكان تحديد القيمة الافتراضية للوسيط
Request.methodضمن الصنف نفسه. - في الإصدار 3.6 من بايثون لا يُطلق أي خطأ إن لم تُزوّد الترويسة
Content-Lengthولم تكن قيمة المعاملdataهيNoneأو كائن بايتات. استخدم ترميز النقل المقطّع chunked transfer encoding عوضًا عن ذلك.
كائنات Request
تصف التوابع التالية الواجهة العامة لكائنات Request ويمكن إعادة تعريف هذه التوابع في الأصناف المتفرّعة عن هذا الصنف. تقدّم هذه الكائنات كذلك مجموعة من الخصائص العامة التي يمكن استخدامها بواسطة العميل لتعقّب الطلب المفسّر.
الخاصية Request.full_url
عنوان URL الأصلي والممرّر إلى الدالة البانية.
يمكن تعيين قيمة للخاصية Request.full_url إضافة إلى قراءة القيمة وحذفها. تعيد عملية قراءة القيمة عنوان الطلب الأصلي مع القطعة fragment إن كانت موجودة.
الخاصية Request.type
مخطط URI.
الخاصية Request.host
صلاحية URI، عادة تكون مضيفًا، ولكن يمكن أن يتضمّن منفذًا مفصولًا عن المضيف بنقطتين رأسيتين.
الخاصية Request.origin_req_host
المضيف الأصلي للطلب، من دون المنفذ.
الخاصية Request.selector
مسار URI. إن استخدم كائن Request وسيطًا، فإنّ المنتقي سيكون عنوان URL الكامل الذي مُرِّر إلى الوسيط.
الخاصية Request.data
متن الطلب، أو القيمة None في حال عدم تعيينه.
ملاحظة: في الإصدار 3.4 من بايثون يؤدي تغيير قيمة Request.data إلى حذف الترويسة "Content-Length" إن كانت معيّنة أو محسوبة في السابق.
الخاصية Request.unverifiable
قيمة منطقية تحدّد ما إذا كان الطلب غير قابل للتوثيق unverifiable كما هو معرّف في المعيار RFC 2965.
الخاصية Request.method
تحدّد هذه الخاصية الطريقة المتّبعة لإرسال طلب HTTP. القيمة الافتراضية لهذه الخاصية هي None، والتي تعني أنّ التابع get_method() سيؤدي عملها بصورة طبيعية. يمكن تعيين قيمة هذه الخاصية (وإعادة تعريف طريقة العمل الافتراضية للتابع get_method()) إمّا بتقديم قيمة افتراضية عن طريق تعيينها على مستوى الصنف في الأصناف المتفرّعة من الصنف Request، أو بتمرير القيمة إلى الدالة البانية للصنف Request عبر الوسيط method.
ملاحظات:
- هذه الخاصية جديدة في الإصدار 3.3 من بايثون.
- في الإصدار 3.4 من بايثون أصبح بالإمكان تعيين قيمة افتراضية في الصنف الفرعي، أما في الإصدارات السابقة فقد كانت الطريقة الوحيدة هي تعيين القيمة في الدالة البانية.
التابع Request.get_method()
يعيد التابع سلسلة نصية تحدّد الطريقة المتّبعة في إرسال طلب HTTP.
التابع Request.add_header()
يضيف التابع ترويسة جديدة إلى الطلب.
التابع Request.add_unredirected_header()
يضيف التابع ترويسة لن تُضاف إلى الطلب المعاد توجيهه.
التابع Request.has_header()
يتحقّق التابع من امتلاك نسخة الكائن لترويسة مسمّاة (يتفحّص التابع الطلبات العادية وغير المعاد توجيهها).
التابع Request.remove_header()
يحذف التابع الترويسة المسمّاة من نسخة الكائن (من الترويسات العادية وغير المعاد توجيهها).
ملاحظة: هذا التابع جديد في الإصدار 3.4 من بايثون.
التابع Request.get_full_url()
يعيد التابع عنوان URL المعطى في الدالة البانية للصنف.
ملاحظة: في الإصدار 3.4 من بايثون، يعيد التابع قيمة الخاصية Request.full_url.
التابع Request.set_proxy()
يحضِّر التابع الطلب عن طريق الاتصال بمخدّم وسيط proxy server.
التابع Request.get_header()
يعيد التابع قيمة الترويسة المعطاة.
التابع Request.header_items()
يعيد التابع الترويسات في كائن Request على هيئة قائمة من صفوف بهيئة (اسم الترويسة، قيمة الترويسة).
ملاحظة: كانت التوابع add_data ،has_data ،get_data ،get_type ،get_host ،get_selector ،get_origin_req_host ،is_unverifiable مهملة في الإصدار 3.3 من بايثون، وقد حذفت في الإصدار 3.4.