الفرق بين المراجعتين لصفحة: «Python/webbrowser/get»

من موسوعة حسوب
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>webbrowser.get()‎‎</code> في بايثون}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>webbrowser.get()‎‎</code> في بايثون}}</noinclude>


تعيد الدالة كائن controller لنوع المتصفّح المعطى.
تعيد الدالة كائن <code>controller</code> لنوع المتصفّح المعطى.
== البنية العامة ==
== البنية العامة ==


سطر 11: سطر 11:
إن أخذ هذا المعامل القيمة <code>None</code> فإنّ الدالة ستعيد كائنًا للمتصفّح الافتراضي يكون ملائمًا لبيئة الاستدعاء.
إن أخذ هذا المعامل القيمة <code>None</code> فإنّ الدالة ستعيد كائنًا للمتصفّح الافتراضي يكون ملائمًا لبيئة الاستدعاء.


راجع الدالة <code>[[Python/webbrowser/register|register()‎]]</code> للاطلاع على القيم المتاحة لهذا المعامل.
هناك عددٌ من أنواع المتصفّحات المعرّفة مسبقًا، ويبين الجدول التالي أسماء هذه الأنواع والتي يمكن تمريرها إلى الدالة <code>get()‎</code> وإنشاء أصناف ذات أنواع مختلفة:
{| class="wikitable"
!اسم المتصفح
!الصنف
!ملاحظات
|-
|<code>'mozilla'</code>
|<code>Mozilla('mozilla')‎</code>
|-
|<code>'firefox'</code>
|<code>Mozilla('mozilla')‎</code>
|-
|<code>'netscape'</code>
|<code>Mozilla('netscape')‎</code>
|-
|<code>'galeon'</code>
|<code>Galeon('galeon')‎</code>
|-
|<code>'epiphany'</code>
|<code>Galeon('epiphany')‎</code>
|-
|<code>'skipstone'</code>
|<code>BackgroundBrowser('skipstone')‎</code>
|-
|<code>'kfmclient'</code>
|<code>Konqueror()‎</code>
|(1)
|-
|<code>'konqueror'</code>
|<code>Konqueror()‎</code>
|(1)
|-
|<code>'kfm'</code>
|<code>Konqueror()‎</code>
|(1)
|-
|<code>'mosaic'</code>
|<code>BackgroundBrowser('mosaic')‎</code>
|-
|<code>'opera'</code>
|<code>Opera()‎</code>
|-
|<code>'grail'</code>
|<code>Grail()‎</code>
|-
|<code>'links'</code>
|<code>GenericBrowser('links')‎</code>
|-
|<code>'elinks'</code>
|<code>Elinks('elinks')‎</code>
|-
|<code>'lynx'</code>
|<code>GenericBrowser('lynx')‎</code>
|-
|<code>'w3m'</code>
|<code>GenericBrowser('w3m')‎</code>
|-
|<code>'windows-default'</code>
|<code>WindowsDefault</code>
|(2)
|-
|<code>'macosx'</code>
|<code>MacOSX('default')‎</code>
|(3)
|-
|<code>'safari'</code>
|<code>MacOSX('safari')‎</code>
|(3)
|-
|<code>'google-chrome'</code>
|<code>Chrome('google-chrome')‎</code>
|-
|<code>'chrome'</code>
|<code>Chrome('chrome')‎</code>
|-
|<code>'chromium'</code>
|<code>Chromium('chromium')‎</code>
|-
|<code>'chromium-browser'</code>
|<code>Chromium('chromium-browser')‎</code>
|}
'''ملاحظات:'''
 
1- المتصفّح <code>"Konqueror"</code> هو مدير الملفات الخاص بسطح المكتب KDE في أنظمة يونكس ومن المنطقي استخدامه مع بيئة سطح المكتب هذه فقط. لا يمكن الاعتماد على المتغير <code>KDEDIR</code> للكشف عن بيئة KDE؛ بل يجب اعتماد طريقة أفضل للقيام بذلك. ويجدر الانتباه إلى أن الاسم <code>"kfm"</code> يستخدم حتى عند استخدام الأمر <code>konqueror</code> مع KDE 2، لذا فإنّ الوحدة تحاول اختيار أفضل طريقة لتشغيل Konqueror.
 
2- يعمل على نظام ويندوز فقط.
 
3- يعمل على نظام Mac OS X فقط.
 
'''ملاحظة:''' أضيف دعم المتصفحين Chrome و Chromium في الإصدار 3.3 من بايثون.


== القيمة المعادة ==
== القيمة المعادة ==
تعيد الدالة كائن controller لنوع المتصفّح المعطى.
تعيد الدالة كائن <code>controller</code> لنوع المتصفّح المعطى.


== أمثلة ==
== أمثلة ==


يبين المثال التالي طريقة عمل التابع:
يبين المثال التالي كيفية استخدام الدالة:


<syntaxhighlight lang="python3">
<syntaxhighlight lang="python3">

المراجعة الحالية بتاريخ 19:20، 25 ديسمبر 2018


تعيد الدالة كائن controller لنوع المتصفّح المعطى.

البنية العامة

webbrowser.get(using=None)

المعاملات

‎using

إن أخذ هذا المعامل القيمة None فإنّ الدالة ستعيد كائنًا للمتصفّح الافتراضي يكون ملائمًا لبيئة الاستدعاء.

هناك عددٌ من أنواع المتصفّحات المعرّفة مسبقًا، ويبين الجدول التالي أسماء هذه الأنواع والتي يمكن تمريرها إلى الدالة get()‎ وإنشاء أصناف ذات أنواع مختلفة:

اسم المتصفح الصنف ملاحظات
'mozilla' Mozilla('mozilla')‎  
'firefox' Mozilla('mozilla')‎  
'netscape' Mozilla('netscape')‎  
'galeon' Galeon('galeon')‎  
'epiphany' Galeon('epiphany')‎  
'skipstone' BackgroundBrowser('skipstone')‎  
'kfmclient' Konqueror()‎ (1)
'konqueror' Konqueror()‎ (1)
'kfm' Konqueror()‎ (1)
'mosaic' BackgroundBrowser('mosaic')‎  
'opera' Opera()‎  
'grail' Grail()‎  
'links' GenericBrowser('links')‎  
'elinks' Elinks('elinks')‎  
'lynx' GenericBrowser('lynx')‎  
'w3m' GenericBrowser('w3m')‎  
'windows-default' WindowsDefault (2)
'macosx' MacOSX('default')‎ (3)
'safari' MacOSX('safari')‎ (3)
'google-chrome' Chrome('google-chrome')‎  
'chrome' Chrome('chrome')‎  
'chromium' Chromium('chromium')‎  
'chromium-browser' Chromium('chromium-browser')‎  

ملاحظات:

1- المتصفّح "Konqueror" هو مدير الملفات الخاص بسطح المكتب KDE في أنظمة يونكس ومن المنطقي استخدامه مع بيئة سطح المكتب هذه فقط. لا يمكن الاعتماد على المتغير KDEDIR للكشف عن بيئة KDE؛ بل يجب اعتماد طريقة أفضل للقيام بذلك. ويجدر الانتباه إلى أن الاسم "kfm" يستخدم حتى عند استخدام الأمر konqueror مع KDE 2، لذا فإنّ الوحدة تحاول اختيار أفضل طريقة لتشغيل Konqueror.

2- يعمل على نظام ويندوز فقط.

3- يعمل على نظام Mac OS X فقط.

ملاحظة: أضيف دعم المتصفحين Chrome و Chromium في الإصدار 3.3 من بايثون.

القيمة المعادة

تعيد الدالة كائن controller لنوع المتصفّح المعطى.

أمثلة

يبين المثال التالي كيفية استخدام الدالة:

>>> import webbrowser
>>> firefox = webbrowser.get('firefox')
>>> type(firefox)
<class 'webbrowser.Mozilla'>
>>> opera = webbrowser.get('opera')
>>> type(opera)
<class 'webbrowser.Opera'>
>>> chrome = webbrowser.get('/usr/bin/google-chrome')    # في أنظمة يونكس
>>> type(chrome)
<class 'webbrowser.Chrome'>

انظر أيضًا

  • الدالة webbrowser.register()‎: تسجّل الدالة نوع المتصفّح المعطى، وبعد تسجيل نوع المتصفّح باستخدام هذه الدالة يصبح بإمكان الدالة get()‎ أن تعيد متحكّمًا لنوع المتصفّح المسجَّل.

مصادر