এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

chrome.windows

বর্ণনা

ব্রাউজার উইন্ডোর সাথে ইন্টারঅ্যাক্ট করতে chrome.windows API ব্যবহার করুন। আপনি ব্রাউজারে উইন্ডোজ তৈরি, সংশোধন এবং পুনর্বিন্যাস করতে এই API ব্যবহার করতে পারেন।

অনুমতি

অনুরোধ করা হলে, একটি windows.Window tabs.Tab অবজেক্টের একটি অ্যারে থাকে। আপনার যদি tabs.Tab এর url , pendingUrl , title বা favIconUrl বৈশিষ্ট্যগুলিতে অ্যাক্সেসের প্রয়োজন হয় তবে আপনাকে অবশ্যই আপনার ম্যানিফেস্টে "tabs" অনুমতি ঘোষণা করতে হবে। যেমন:

{
  "name": "My extension",
  ...
  "permissions": ["tabs"],
  ...
}

ধারণা এবং ব্যবহার

বর্তমান জানালা

এক্সটেনশন সিস্টেমের অনেক ফাংশন একটি ঐচ্ছিক windowId আর্গুমেন্ট নেয়, যা বর্তমান উইন্ডোতে ডিফল্ট হয়।

বর্তমান উইন্ডো হল সেই উইন্ডো যেটিতে কোড রয়েছে যা বর্তমানে কার্যকর করা হচ্ছে। এটা উপলব্ধি করা গুরুত্বপূর্ণ যে এটি উপরের বা ফোকাস করা উইন্ডো থেকে আলাদা হতে পারে।

উদাহরণস্বরূপ, বলুন যে একটি এক্সটেনশন একটি একক HTML ফাইল থেকে কয়েকটি ট্যাব বা উইন্ডো তৈরি করে এবং HTML ফাইলটিতে tabs.query() এ একটি কল রয়েছে। বর্তমান উইন্ডো হল সেই উইন্ডো যেখানে কল করা পৃষ্ঠাটি রয়েছে, শীর্ষ উইন্ডো যাই হোক না কেন।

পরিষেবা কর্মীদের ক্ষেত্রে, বর্তমান উইন্ডোটির মান শেষ সক্রিয় উইন্ডোতে ফিরে আসে। কিছু পরিস্থিতিতে, পটভূমি পৃষ্ঠাগুলির জন্য কোন বর্তমান উইন্ডো নাও থাকতে পারে।

উদাহরণ

এই APIটি চেষ্টা করতে, chrome-extension-sample repository থেকে windows API উদাহরণটি ইনস্টল করুন।

প্রকারভেদ

CreateType

Chrome 44+

কোন ধরনের ব্রাউজার উইন্ডো তৈরি করতে হবে তা নির্দিষ্ট করে। 'প্যানেল' বাতিল করা হয়েছে এবং শুধুমাত্র Chrome OS-এ বিদ্যমান অনুমোদিত তালিকাভুক্ত এক্সটেনশনগুলিতে উপলব্ধ।

এনাম

"স্বাভাবিক"
উইন্ডোটিকে একটি আদর্শ উইন্ডো হিসাবে নির্দিষ্ট করে।

"পপআপ"
উইন্ডোটিকে একটি পপআপ উইন্ডো হিসাবে নির্দিষ্ট করে।

"প্যানেল"
একটি প্যানেল হিসাবে উইন্ডো নির্দিষ্ট করে।

QueryOptions

Chrome 88+

বৈশিষ্ট্য

জনবহুল
বুলিয়ান ঐচ্ছিক
সত্য হলে, windows.Window অবজেক্টের একটি tabs বৈশিষ্ট্য রয়েছে যাতে tabs.Tab একটি তালিকা থাকে। Tab অবজেক্টে শুধুমাত্র url , pendingUrl , title , এবং favIconUrl বৈশিষ্ট্য থাকে যদি এক্সটেনশনের ম্যানিফেস্ট ফাইলে "tabs" অনুমতি থাকে।
উইন্ডো প্রকার
WindowType [] ঐচ্ছিক
সেট করা হলে, windows.Window রিটার্ন করা উইন্ডো তার প্রকারের উপর ভিত্তি করে ফিল্টার করা হয়। সেট না থাকলে, ডিফল্ট ফিল্টারটি ['normal', 'popup'] এ সেট করা হয়।

Window

বৈশিষ্ট্য

সর্বদা অনটপ
বুলিয়ান
উইন্ডোটি সর্বদা উপরে থাকবে কিনা।
নিবদ্ধ
বুলিয়ান
উইন্ডোটি বর্তমানে ফোকাস করা উইন্ডো কিনা।
উচ্চতা
সংখ্যা ঐচ্ছিক
ফ্রেম সহ উইন্ডোর উচ্চতা পিক্সেলে। কিছু পরিস্থিতিতে একটি উইন্ডো একটি height সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, যখন sessions API থেকে বন্ধ উইন্ডোগুলি অনুসন্ধান করা হয়।
আইডি
সংখ্যা ঐচ্ছিক
জানালার আইডি। একটি ব্রাউজার সেশনের মধ্যে উইন্ডো আইডি অনন্য। কিছু পরিস্থিতিতে একটি উইন্ডো একটি ID সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, sessions এপিআই ব্যবহার করে উইন্ডোজ অনুসন্ধান করার সময়, এই ক্ষেত্রে একটি সেশন আইডি উপস্থিত থাকতে পারে।
ছদ্মবেশী
বুলিয়ান
উইন্ডোটি ছদ্মবেশী কিনা।
বাম
সংখ্যা ঐচ্ছিক
পিক্সেলে পর্দার বাম প্রান্ত থেকে উইন্ডোর অফসেট। কিছু পরিস্থিতিতে একটি উইন্ডো একটি left সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, যখন sessions API থেকে বন্ধ উইন্ডোগুলি অনুসন্ধান করা হয়।
সেশন আইডি
স্ট্রিং ঐচ্ছিক
sessions API থেকে প্রাপ্ত একটি উইন্ডোকে অনন্যভাবে সনাক্ত করতে ব্যবহৃত সেশন আইডি।
রাষ্ট্র
WindowState ঐচ্ছিক
এই ব্রাউজার উইন্ডোর অবস্থা।
ট্যাব
ট্যাব [] ঐচ্ছিক
tabs.Tab অ্যারে। ট্যাব অবজেক্টগুলি উইন্ডোতে বর্তমান ট্যাবগুলিকে উপস্থাপন করে।
শীর্ষ
সংখ্যা ঐচ্ছিক
পিক্সেলে পর্দার উপরের প্রান্ত থেকে উইন্ডোটির অফসেট। কিছু পরিস্থিতিতে একটি উইন্ডো একটি top সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, যখন sessions API থেকে বন্ধ উইন্ডোগুলি অনুসন্ধান করা হয়।
টাইপ
উইন্ডো টাইপ ঐচ্ছিক
ব্রাউজার উইন্ডোর ধরন এটি।
প্রস্থ
সংখ্যা ঐচ্ছিক
ফ্রেম সহ উইন্ডোর প্রস্থ পিক্সেলে। কিছু পরিস্থিতিতে একটি উইন্ডো একটি width সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, যখন sessions API থেকে বন্ধ উইন্ডোগুলি অনুসন্ধান করা হয়।

WindowState

Chrome 44+

এই ব্রাউজার উইন্ডোর অবস্থা। কিছু পরিস্থিতিতে একটি উইন্ডো একটি state সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, যখন sessions API থেকে বন্ধ উইন্ডোগুলি অনুসন্ধান করা হয়।

এনাম

"স্বাভাবিক"
সাধারণ উইন্ডোর অবস্থা (ছোট নয়, সর্বাধিক করা বা পূর্ণস্ক্রীন)।

"নিম্ন করা"
মিনিমাইজ করা উইন্ডোর অবস্থা।

"সর্বোচ্চ করা"
সর্বাধিক উইন্ডো স্থিতি।

"পূর্ণ পর্দা"
ফুলস্ক্রিন উইন্ডোর অবস্থা।

"লক-পূর্ণ স্ক্রীন"
লক করা ফুলস্ক্রিন উইন্ডোর অবস্থা। এই পূর্ণস্ক্রীন অবস্থা ব্যবহারকারীর ক্রিয়া দ্বারা প্রস্থান করা যাবে না এবং শুধুমাত্র Chrome OS-এ অনুমোদিত তালিকাভুক্ত এক্সটেনশনগুলির জন্য উপলব্ধ৷

WindowType

Chrome 44+

ব্রাউজার উইন্ডোর ধরন এটি। কিছু পরিস্থিতিতে একটি উইন্ডো একটি type সম্পত্তি বরাদ্দ নাও হতে পারে; উদাহরণস্বরূপ, যখন sessions API থেকে বন্ধ উইন্ডোগুলি অনুসন্ধান করা হয়।

এনাম

"স্বাভাবিক"
একটি সাধারণ ব্রাউজার উইন্ডো।

"পপআপ"
একটি ব্রাউজার পপআপ.

"প্যানেল"
এই এপিআইতে অবহেলিত। একটি Chrome অ্যাপ প্যানেল-স্টাইল উইন্ডো। এক্সটেনশন শুধুমাত্র তাদের নিজস্ব প্যানেল উইন্ডো দেখতে পারে.

"অ্যাপ"
এই এপিআইতে অবহেলিত। একটি Chrome অ্যাপ উইন্ডো। এক্সটেনশানগুলি শুধুমাত্র তাদের অ্যাপের নিজস্ব উইন্ডো দেখতে পারে৷

"devtools"
একটি বিকাশকারী সরঞ্জাম উইন্ডো।

বৈশিষ্ট্য

WINDOW_ID_CURRENT

windowId মান যা বর্তমান উইন্ডোকে উপস্থাপন করে।

মান

-2

WINDOW_ID_NONE

windowId মান যা একটি Chrome ব্রাউজার উইন্ডোর অনুপস্থিতিকে উপস্থাপন করে।

মান

-1

পদ্ধতি

create()

chrome.windows.create(
  createData?: object,
): Promise<Window | undefined>

যে কোনো ঐচ্ছিক আকার, অবস্থান, বা ডিফল্ট URL প্রদান করে একটি নতুন ব্রাউজার উইন্ডো তৈরি করে (খোলে)।

পরামিতি

ডেটা তৈরি করুন
বস্তু ঐচ্ছিক
- নিবদ্ধ
  বুলিয়ান ঐচ্ছিক
  true হলে, একটি সক্রিয় উইন্ডো খোলে। false হলে, একটি নিষ্ক্রিয় উইন্ডো খোলে।
- উচ্চতা
  সংখ্যা ঐচ্ছিক
  ফ্রেম সহ নতুন উইন্ডোর পিক্সেলে উচ্চতা। নির্দিষ্ট করা না থাকলে, স্বাভাবিক উচ্চতায় ডিফল্ট।
- ছদ্মবেশী
  বুলিয়ান ঐচ্ছিক
  নতুন উইন্ডোটি একটি ছদ্মবেশী উইন্ডো হওয়া উচিত কিনা।
- বাম
  সংখ্যা ঐচ্ছিক
  স্ক্রিনের বাম প্রান্ত থেকে নতুন উইন্ডোর অবস্থানের জন্য পিক্সেলের সংখ্যা। নির্দিষ্ট করা না থাকলে, নতুন উইন্ডো স্বাভাবিকভাবে শেষ ফোকাস করা উইন্ডো থেকে অফসেট হয়। প্যানেলের জন্য এই মান উপেক্ষা করা হয়।
- SelfAsOpener সেট করুন
  বুলিয়ান ঐচ্ছিক
  Chrome 64+
  true হলে, নতুন-তৈরি উইন্ডোর 'window.opener' কলারের জন্য সেট করা হয় এবং কলকারীর সাথে সম্পর্কিত ব্রাউজিং প্রসঙ্গের একই ইউনিটে থাকে।
- রাষ্ট্র
  WindowState ঐচ্ছিক
  Chrome 44+
  জানালার প্রাথমিক অবস্থা। minimized , maximized , এবং fullscreen স্টেটগুলিকে left , top , width বা height সাথে একত্রিত করা যাবে না।
- ট্যাবআইডি
  সংখ্যা ঐচ্ছিক
  নতুন উইন্ডোতে যোগ করার জন্য ট্যাবের আইডি।
- শীর্ষ
  সংখ্যা ঐচ্ছিক
  স্ক্রিনের উপরের প্রান্ত থেকে নতুন উইন্ডোর অবস্থানের জন্য পিক্সেলের সংখ্যা। নির্দিষ্ট করা না থাকলে, নতুন উইন্ডো স্বাভাবিকভাবে শেষ ফোকাস করা উইন্ডো থেকে অফসেট হয়। প্যানেলের জন্য এই মান উপেক্ষা করা হয়।
- টাইপ
  CreateType ঐচ্ছিক
  কোন ধরনের ব্রাউজার উইন্ডো তৈরি করতে হবে তা নির্দিষ্ট করে।
- url
  স্ট্রিং | স্ট্রিং[] ঐচ্ছিক
  উইন্ডোতে ট্যাব হিসাবে খোলার জন্য একটি URL বা URL এর বিন্যাস৷ সম্পূর্ণ-যোগ্য URL-এ অবশ্যই একটি স্কিম অন্তর্ভুক্ত করতে হবে, যেমন, 'http://www.google.com', 'www.google.com' নয়। অ-পূর্ণ-যোগ্য URLগুলিকে এক্সটেনশনের মধ্যে আপেক্ষিক হিসাবে বিবেচনা করা হয়। নতুন ট্যাব পৃষ্ঠায় ডিফল্ট।
- প্রস্থ
  সংখ্যা ঐচ্ছিক
  ফ্রেম সহ নতুন উইন্ডোর পিক্সেলের প্রস্থ। নির্দিষ্ট করা না থাকলে, একটি প্রাকৃতিক প্রস্থ ডিফল্ট।

রিটার্নস

প্রতিশ্রুতি< উইন্ডো | undefined>
Chrome 88+

get()

chrome.windows.get(
  windowId: number,
  queryOptions?: QueryOptions,
): Promise<Window>

একটি উইন্ডো সম্পর্কে বিস্তারিত পায়.

পরামিতি

উইন্ডো আইডি
সংখ্যা
query অপশন
QueryOptions ঐচ্ছিক
Chrome 88+

রিটার্নস

প্রতিশ্রুতি < উইন্ডো >
Chrome 88+

getAll()

chrome.windows.getAll(
  queryOptions?: QueryOptions,
): Promise<Window[]>

সব জানালা পায়.

পরামিতি

query অপশন
QueryOptions ঐচ্ছিক
Chrome 88+

রিটার্নস

প্রতিশ্রুতি< উইন্ডো []>
Chrome 88+

getCurrent()

chrome.windows.getCurrent(
  queryOptions?: QueryOptions,
): Promise<Window>

বর্তমান উইন্ডো পায়.

পরামিতি

query অপশন
QueryOptions ঐচ্ছিক
Chrome 88+

রিটার্নস

প্রতিশ্রুতি < উইন্ডো >
Chrome 88+

getLastFocused()

chrome.windows.getLastFocused(
  queryOptions?: QueryOptions,
): Promise<Window>

সবচেয়ে সম্প্রতি ফোকাস করা উইন্ডোটি পায় — সাধারণত 'উপরে' উইন্ডো।

পরামিতি

query অপশন
QueryOptions ঐচ্ছিক
Chrome 88+

রিটার্নস

প্রতিশ্রুতি < উইন্ডো >
Chrome 88+

remove()

chrome.windows.remove(
  windowId: number,
): Promise<void>

একটি উইন্ডো এবং এর ভিতরে থাকা সমস্ত ট্যাব সরিয়ে (বন্ধ করে)।

পরামিতি

উইন্ডো আইডি
সংখ্যা

রিটার্নস

প্রতিশ্রুতি <void>
Chrome 88+

update()

chrome.windows.update(
  windowId: number,
  updateInfo: object,
): Promise<Window>

একটি উইন্ডোর বৈশিষ্ট্য আপডেট করে। শুধুমাত্র যে বৈশিষ্ট্যগুলি পরিবর্তন করতে হবে তা নির্দিষ্ট করুন; অনির্দিষ্ট বৈশিষ্ট্য অপরিবর্তিত।

পরামিতি

উইন্ডো আইডি
সংখ্যা
আপডেট তথ্য
বস্তু
- মনোযোগ আকর্ষণ
  বুলিয়ান ঐচ্ছিক
  true হলে , উইন্ডোটিকে এমনভাবে প্রদর্শন করা হয় যা উইন্ডোটির দিকে ব্যবহারকারীর দৃষ্টি আকর্ষণ করে, ফোকাস করা উইন্ডো পরিবর্তন না করে। ব্যবহারকারী উইন্ডোতে ফোকাস পরিবর্তন না করা পর্যন্ত প্রভাব স্থায়ী হয়। উইন্ডোতে ইতিমধ্যেই ফোকাস থাকলে এই বিকল্পটির কোন প্রভাব নেই। পূর্ববর্তী drawAttention অনুরোধ বাতিল করতে false সেট করুন।
- নিবদ্ধ
  বুলিয়ান ঐচ্ছিক
  true হলে, জানালাটিকে সামনে নিয়ে আসে; রাষ্ট্রের সাথে 'মিনিমাইজ' করা যাবে না। false হলে, z-ক্রমের পরবর্তী উইন্ডোটিকে সামনে নিয়ে আসে; স্টেট 'ফুলস্ক্রিন' বা 'সর্বোচ্চ' এর সাথে একত্রিত করা যাবে না।
- উচ্চতা
  সংখ্যা ঐচ্ছিক
  উইন্ডোটির আকার পরিবর্তন করার জন্য পিক্সেলে উচ্চতা। প্যানেলের জন্য এই মান উপেক্ষা করা হয়।
- বাম
  সংখ্যা ঐচ্ছিক
  উইন্ডোটিকে পিক্সেলে সরানোর জন্য পর্দার বাম প্রান্ত থেকে অফসেট। প্যানেলের জন্য এই মান উপেক্ষা করা হয়।
- রাষ্ট্র
  WindowState ঐচ্ছিক
  জানালার নতুন অবস্থা। 'মিনিমাইজড', 'সর্বোচ্চ', এবং 'পূর্ণস্ক্রীন' অবস্থাগুলিকে 'বাম', 'শীর্ষ', 'প্রস্থ' বা 'উচ্চতা'-এর সাথে একত্রিত করা যাবে না।
- শীর্ষ
  সংখ্যা ঐচ্ছিক
  উইন্ডোটিকে পিক্সেলে সরানোর জন্য পর্দার উপরের প্রান্ত থেকে অফসেট। প্যানেলের জন্য এই মান উপেক্ষা করা হয়।
- প্রস্থ
  সংখ্যা ঐচ্ছিক
  উইন্ডোটির আকার পরিবর্তন করতে পিক্সেলে প্রস্থ। প্যানেলের জন্য এই মান উপেক্ষা করা হয়।

রিটার্নস

প্রতিশ্রুতি < উইন্ডো >
Chrome 88+

ঘটনা

onBoundsChanged

Chrome 86+

chrome.windows.onBoundsChanged.addListener(
  callback: function,
)

একটি উইন্ডোর আকার পরিবর্তন করা হলে গুলি করা হয়েছে; এই ইভেন্টটি শুধুমাত্র তখনই পাঠানো হয় যখন নতুন সীমানা প্রতিশ্রুতিবদ্ধ হয়, এবং অগ্রগতি পরিবর্তনের জন্য নয়।

পরামিতি

কলব্যাক
ফাংশন
callback প্যারামিটারটি এর মতো দেখাচ্ছে:
```
(window: Window) => void
```
- জানালা
  জানালা

onCreated

chrome.windows.onCreated.addListener(
  callback: function,
  filters?: object,
)

একটি উইন্ডো তৈরি করা হলে ফায়ার করা হয়।

পরামিতি

কলব্যাক
ফাংশন
Chrome 46+
callback প্যারামিটারটি এর মতো দেখাচ্ছে:
```
(window: Window) => void
```
- জানালা
  জানালা
  তৈরি করা উইন্ডোর বিশদ বিবরণ।
ফিল্টার
বস্তু ঐচ্ছিক
- উইন্ডো প্রকার
  উইন্ডো টাইপ []
  যে শর্তাবলী উইন্ডোর প্রকার তৈরি করা হচ্ছে তা অবশ্যই পূরণ করতে হবে। ডিফল্টরূপে এটি ['normal', 'popup'] সন্তুষ্ট করে।

onFocusChanged

chrome.windows.onFocusChanged.addListener(
  callback: function,
  filters?: object,
)

বর্তমানে ফোকাস করা উইন্ডো পরিবর্তিত হলে ফায়ার করা হয়েছে। সমস্ত Chrome উইন্ডো ফোকাস হারিয়ে গেলে chrome.windows.WINDOW_ID_NONE প্রদান করে৷ দ্রষ্টব্য: কিছু লিনাক্স উইন্ডো ম্যানেজারে, WINDOW_ID_NONE সর্বদা একটি Chrome উইন্ডো থেকে অন্য ক্রোম উইন্ডোতে স্যুইচ করার আগে অবিলম্বে পাঠানো হয়।

পরামিতি

কলব্যাক
ফাংশন
Chrome 46+
callback প্যারামিটারটি এর মতো দেখাচ্ছে:
```
(windowId: number) => void
```
- উইন্ডো আইডি
  সংখ্যা
  সদ্য ফোকাস করা উইন্ডোর আইডি।
ফিল্টার
বস্তু ঐচ্ছিক
- উইন্ডো প্রকার
  উইন্ডো টাইপ []
  যে শর্তাবলী উইন্ডোর ধরন সরানো হচ্ছে তা অবশ্যই পূরণ করতে হবে। ডিফল্টরূপে এটি ['normal', 'popup'] সন্তুষ্ট করে।

onRemoved

chrome.windows.onRemoved.addListener(
  callback: function,
  filters?: object,
)

একটি উইন্ডো সরানো হলে গুলি করা হয় (বন্ধ)।

পরামিতি

কলব্যাক
ফাংশন
Chrome 46+
callback প্যারামিটারটি এর মতো দেখাচ্ছে:
```
(windowId: number) => void
```
- উইন্ডো আইডি
  সংখ্যা
  সরানো উইন্ডোর আইডি।
ফিল্টার
বস্তু ঐচ্ছিক
- উইন্ডো প্রকার
  উইন্ডো টাইপ []
  যে শর্তাবলী উইন্ডোর ধরন সরানো হচ্ছে তা অবশ্যই পূরণ করতে হবে। ডিফল্টরূপে এটি ['normal', 'popup'] সন্তুষ্ট করে।