Mac पर शॉर्टकट में “वेबपृष्ठ पर JavaScript रन करें” क्रिया का परिचय

वेबपृष्ठ डेटा निकालने के बारे में

“वेबपृष्ठ पर JavaScript चलाएँ” क्रिया से आप निश्चित मानदंड का पालन करने वाले सभी ऐलिमेंट को मिलाकर किसी वेबपृष्ठ से डेटा निकाल सकते हैं फिर उस डेटा के साथ कार्य पूरा करने के लिए (या ऐलिमेंट के फिर निरीक्षण के लिए) उन ऐलिमेंट को दोहराएँ।

उदाहरण के लिए, वेबपृष्ठ पर हरेक इमेज एलिमेंट की सूची बनाने के लिए, इसे उपयोग करें :

var elements = document.querySelectorAll("img");

दूसरे उदाहरण में, कक्षा “पोस्ट” के साथ हरेक एलिमेंट को निकालने के लिए, इसे उपयोग करें :

var elements = document.querySelectorAll(".post");

एक बार NodeList बन जाने पर, आप (फिर एलिमेंट फ़िल्टर करने या किसी डेटा स्ट्रक्चर में एलिमेंट जोड़ने के लिए) एलिमेंट दोहरा सकते हैं, निम्न जैसों का उपयोग करके :

वेबपृष्ठ परिणामों की पूछताछ की अधिक जानकारी के लिए https://developer.mozilla.org/Selectors और https://developer.mozilla.org/SelectorAll देखें।

“वेबपृष्ठ पर JavaScript चलाएँ” क्रिया इनपुट

“वेबपृष्ठ पर JavaScript चलाएँ” क्रिया का इनपुट सक्रिय Safari वेबपृष्ठ होना चाहिए जिसका मतलब है कि आपके द्वारा शेयर शीट से (विशेष रूप से Safari, SFSafariViewController या ASWebAuthenticationSession से) शॉर्टकट चलाया जाना चाहिए।

जब कोई शॉर्टकट शेयर शीट से रन होता है, तो इनपुट Safari ऐप से आपके शॉर्टकट की पहली क्रिया में पास हो जाता है।

भले ही “वेबपृष्ठ पर JavaScript चलाएँ” क्रिया में इनपुट एक Safari वेबपृष्ठ होना चाहिए लेकिन आप मैजिक वैरिएबल का उपयोग करके क्रिया में अतिरिक्त डेटा डाल सकते हैं। उदाहरण के लिए, वीडियो गति बदलें शॉर्टकट (गैलरी में उपलब्ध) में “वेबपृष्ठ पर JavaScript रन करें” क्रिया शामिल है जो वेबपृष्ठ पर मौजूद वीडियो को संशोधित करती है। वीडियो की प्लेबैक दर गति वेरिएबल द्वारा नियंत्रित होती है।

Safari से शॉर्टकट रन करने के बारे में जानकारी के लिए, अपने Mac पर काम करते समय शॉर्टकट रन करें देखें।

“वेबपृष्ठ पर JavaScript चलाएँ” क्रिया आउटपुट

डेटा वापस करने के लिए, आपको JavaScript जैसे कि पूर्ण(परिणाम) में कंप्लिशन हैंडलर को कॉल करना होगा। चूंकि JavaScript आमतौर पर ऐसिंक्रोनस पैटर्न के साथ उपयोग होती है, इसलिए कॉल जानबूझकर सिंक्रोनस नहीं होती है। इस तरह, आप क्रिया को ऐसिंक्रोनस रूप से पूरा कर सकते हैं। उदाहरण के लिए, निम्नलिखित वैध है :

“वेबपृष्ठ पर JavaScript चलाएँ” क्रिया का आउटपुट कोई भी मान्य JSON डेटा प्रकार होता है जिसमें निम्न शामिल हैं :

• स्ट्रिंग

• संख्या

• बूलियन (सत्य या असत्य)

• सारणी (कोई भी अन्य वैध JSON प्रकार शामिल है)

• शब्दकोश (कोई भी अन्य वैध JSON प्रकार शामिल है)

• Null

• अनिर्धारित

दृश्यों के पीछे, शॉर्टकट JavaScript और शॉर्टकट ऐप के बीच संचार करने के लिए आपके वापसी मान को ऑटोमैटिकली एंकोड और डीकोड करते हैं। इसका मतलब आपको कंप्लिशन हैंडलर को कॉल करने से पहले JSON.stringify(result) को कॉल करने की ज़रूरत नहीं है।

चूंकि वापसी मान JSON है, इसलिए कुछ वापसी मान सही ढंग से काम नहीं करेंगे। उदाहरण के लिए, फ़ंक्शन या नोड के पास उपयोगी JSON-एंकोडेड प्रस्तुति नहीं होगी। इस स्थिति में, यह अनुशंसित किया जाता है कि आप ऐसी सारणी/शब्दकोश बनाएँ जिसमें आपके आवश्यक JSON-संगत मान शामिल हों।

यदि आप वेबपृष्ठ पर JavaScript चलाएँ क्रिया से कोई डेटा परिणाम में नहीं चाहते हैं, तो आप फ़ंक्शन में बिना आर्ग्युमेंट के पूर्ण() कॉल कर सकते हैं (क्योंकि अनिर्धारित मान्य आउटपुट है)। यह पूर्ण(अनिर्धारित) कॉल करने के समान ही है।

JSON के बारे में अधिक जानकारी के लिए, Mac पर शॉर्टकट में JSON का उपयोग करने के बारे में परिचय देखें।

नोड पर अधिक जानकारी के लिए https://developer.mozilla.org/Node देखें।

फ़ंक्शन पर अधिक जानकारी के लिए https://developer.mozilla.org/Functions देखें।

“वेबपृष्ठ पर JavaScript चलाएँ” क्रिया की समय सीमा

Safari में सभी JavaScript एक्सटेंशन की तरह ही “वेबपृष्ठ पर JavaScript चलाएँ” क्रिया भी समय सीमा का विषय है और इसे जल्द से जल्द पूरा कर देना चाहिए। सिंक्रोनस फ़ंक्शन का उपयोग करने वाली JavaScript हो सकता है समय पर पूरी न हो, निम्न सहित :

• window.alert()

• window.prompt()

• window.confirm()

• कई सेकेंड तक चलने वाली समय समाप्तियाँ—उदाहरण के लिए : window.setTimeout(function() { completion(); }, 5000);

यदि आपकी JavaScript समयसीमा पार करती है, तो शॉर्टकट पूरा होने में विफल हो जाएगा और आप द्वारा शॉर्टकट चलाने पर “JavaScript समय समाप्ति” त्रुटि संदेश दिखेगा।

सिंटैक्स और रनटाइम त्रुटि हैंडलिंग

आप “वेबपृष्ठ पर JavaScript रन करें” क्रिया में JavaScript लिखने के लिए Safari में समर्थित किसी भी सिंटैक्स का उपयोग कर सकते हैं।

शॉर्टकट ऐप में “वेबपृष्ठ पर JavaScript चलाएँ” क्रिया सामान्य सिंटैक्स जाँच करके आपको Safari एक्सटेंशन से शॉर्टकट चलाने से पहले त्रुटियाँ देखने में मदद करती है।

जैसे ही आप टेक्स्ट फ़ील्ड में अपनी स्क्रिप्ट दर्ज करते हैं, सिंटैक्स हाईलाइटिंग यह सुनिश्चित करने में मदद करती है कि आपकी JavaScript वैध है। उदाहरण के लिए, यदि आप स्ट्रिंग के अंत में कोटेशन चिह्न लगाना भूल जाते हैं, तो उस स्ट्रिंग के बाद का सारा टेक्स्ट हाईलाइट हो जाता है।

यदि आपकी स्क्रिप्ट का सिंटैक्स मान्य है लेकिन इसमें रनटाइम त्रुटि शामिल है, तो “वेबपृष्ठ पर JavaScript चलाएँ” क्रिया अपवादों का पता लगाकर उन्हें प्रदर्शित करती है। उदाहरण के लिए, यदि आपकी स्क्रिप्ट ऐसे वेरिएबल या फ़ंक्शन का संदर्भ लेती है जो मौजूद नहीं है (जैसे कि shortcuts.completion()), तो रनटाइम पर एक त्रुटि प्रदर्शित होती है।