Browser Extensions Development (Chrome & Edge) · درس

الاتصال بين مكوّنات واجهة المستخدم

أنشئ قنوات لتبادل الرسائل بين النوافذ المنبثقة وصفحات الخيارات والنصوص البرمجية في الخلفية لضمان تدفق البيانات بسلاسة

الاتصال بين مكوّنات واجهة المستخدم درس مجاني في Browser Extensions Development (Chrome & Edge) على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Browser Extensions Development (Chrome & Edge)، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Browser Extensions Development (Chrome & Edge) 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Bridge Your Extension Components

Browser extensions are made of several parts: popups, options pages, and background scripts. Each part often runs in its own isolated environment.

To build powerful extensions, these components need to talk to each other. This lesson shows you how to establish messaging channels for seamless data flow.

Isolated Environments

Think of your extension's popup, options page, and background script as separate mini-programs. They don't automatically share data or functions.

Popup: Appears when clicked, then closes.
Options Page: A dedicated settings page.
Background Script: Runs continuously, handles events.

Messaging allows them to send information and trigger actions across these boundaries.

UI Components Send Messages

To send a message from your popup or options page to the background script, you use the chrome.runtime.sendMessage() API.

This function lets you pass a JSON object (your message) to other parts of your extension. It's great for triggering actions or sending user input.

Popup to Background Example

Here's how a popup script might send a message to the background script, for instance, to toggle a feature. This JavaScript would be in your popup.js file, linked from popup.html.

// popup.js
document.getElementById('toggleButton').addEventListener('click', () => {
  chrome.runtime.sendMessage({ action: 'toggleFeature', value: true }, (response) => {
    console.log('Received response:', response);
  });
});

Background Listens for Messages

Your background script needs to listen for incoming messages. It does this using the chrome.runtime.onMessage.addListener() event.

This listener will fire whenever any part of your extension (like a popup or options page) sends a message via chrome.runtime.sendMessage().

Background Script Listener

This snippet shows a basic message listener in your background service worker (e.g., background.js). It checks the message's action and performs a task.

// background.js
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  if (message.action === 'toggleFeature') {
    console.log('Feature toggled:', message.value);
    // Perform background task here
    sendResponse({ status: 'success', message: 'Feature updated!' });
  }
  // Important: Return true to indicate you want to send a response asynchronously
  return true; 
});

Sending a Response Back

Often, the component that sent the message (e.g., your popup) needs to know if the action was successful or receive data back.

The sendResponse function, provided as the third argument to your onMessage listener, allows the background script to send a one-time reply to the original sender.

Handling Background Responses

The callback function in chrome.runtime.sendMessage() is where your popup or options page receives the response from the background script. This completes the two-way communication.

// popup.js (modified)
document.getElementById('toggleButton').addEventListener('click', () => {
  chrome.runtime.sendMessage({ action: 'toggleFeature', value: true }, (response) => {
    if (chrome.runtime.lastError) {
      console.error('Error sending message:', chrome.runtime.lastError.message);
      return;
    }
    console.log('Background response:', response);
    // Update popup UI based on response
    document.getElementById('status').textContent = response.message;
  });
});

Options Pages Communicate Too

The same chrome.runtime.sendMessage() and chrome.runtime.onMessage.addListener() pattern applies to communication involving your options page.

An options page can send user-defined settings to the background script for persistence, and the background can reply with confirmation or fetched data.

Messaging Concepts

Consider an extension where a popup needs to ask the background script for the current count of unread notifications.

Which API should the popup use to initiate this request?

Recap: Seamless Data Flow

You've learned how to enable communication between your extension's UI components (popups, options pages) and its background script!

Use chrome.runtime.sendMessage() to send data.
Use chrome.runtime.onMessage.addListener() to receive data and respond.

This fundamental skill allows your extension's different parts to work together effectively.

الأسئلة الشائعة

هل درس «الاتصال بين مكوّنات واجهة المستخدم» مجاني؟

نعم — نص درس «الاتصال بين مكوّنات واجهة المستخدم» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Browser Extensions Development (Chrome & Edge)، انتقل إلى CoddyKit PRO. تتضمن دورة Browser Extensions Development (Chrome & Edge) 4 دروس في المجموع.

ماذا ستتعلم في «الاتصال بين مكوّنات واجهة المستخدم»؟

أنشئ قنوات لتبادل الرسائل بين النوافذ المنبثقة وصفحات الخيارات والنصوص البرمجية في الخلفية لضمان تدفق البيانات بسلاسة تتمرن على Browser Extensions Development (Chrome & Edge) مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Browser Extensions Development (Chrome & Edge)؟

لا تُشترط خبرة سابقة. Browser Extensions Development (Chrome & Edge) على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «الاتصال بين مكوّنات واجهة المستخدم»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Browser Extensions Development (Chrome & Edge) هذا؟

نعم. كل درس في Browser Extensions Development (Chrome & Edge) يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Browser Extensions Development (Chrome & Edge)