chrome.sockets.tcp

বর্ণনা

TCP সংযোগ ব্যবহার করে নেটওয়ার্কে ডেটা পাঠাতে এবং গ্রহণ করতে chrome.sockets.tcp API ব্যবহার করুন৷ এই APIটি পূর্বে chrome.socket API-এ পাওয়া TCP কার্যকারিতাকে ছাড়িয়ে যায়।

উদ্ভাসিত

এই API ব্যবহার করার জন্য নিম্নলিখিত কীগুলি অবশ্যই ম্যানিফেস্টে ঘোষণা করতে হবে৷

"sockets"

প্রকারভেদ

CreateInfo

বৈশিষ্ট্য

  • সকেট আইডি

    সংখ্যা

    নতুন তৈরি সকেটের আইডি। মনে রাখবেন যে এই API থেকে তৈরি সকেট আইডিগুলি অন্যান্য API থেকে তৈরি সকেট আইডিগুলির সাথে সামঞ্জস্যপূর্ণ নয়, যেমন অপ্রচলিত [ সকেট ](../socket/) API।

DnsQueryType

Chrome 103+

DNS রেজোলিউশন পছন্দ। ডিফল্ট any এবং বর্তমান OS কনফিগ ব্যবহার করে যা IPv4 বা IPv6 ফেরত দিতে পারে। ipv4 IPv4 কে জোর করে, এবং ipv6 IPv6 কে জোর করে।

এনাম

"যে কোন"

"ipv4"

"ipv6"

ReceiveErrorInfo

বৈশিষ্ট্য

  • ফলাফল কোড

    সংখ্যা

    অন্তর্নিহিত নেটওয়ার্ক কল থেকে ফলাফল কোড ফিরে এসেছে।

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

ReceiveInfo

বৈশিষ্ট্য

  • তথ্য

    অ্যারেবাফার

    প্রাপ্ত তথ্য, bufferSize সর্বোচ্চ আকার সহ।

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

SecureOptions

বৈশিষ্ট্য

SendInfo

বৈশিষ্ট্য

  • বাইট পাঠানো হয়েছে

    সংখ্যা ঐচ্ছিক

    পাঠানো বাইট সংখ্যা (যদি ফলাফল == 0)

  • ফলাফল কোড

    সংখ্যা

    অন্তর্নিহিত নেটওয়ার্ক কল থেকে ফলাফল কোড ফিরে এসেছে। একটি নেতিবাচক মান একটি ত্রুটি নির্দেশ করে।

SocketInfo

বৈশিষ্ট্য

  • বাফার সাইজ

    সংখ্যা ঐচ্ছিক

    ডেটা গ্রহণ করতে ব্যবহৃত বাফারের আকার। কোনো বাফার আকার স্পষ্টভাবে নির্দিষ্ট করা না থাকলে, মান প্রদান করা হয় না।

  • সংযুক্ত

    বুলিয়ান

    সকেটটি দূরবর্তী পিয়ারের সাথে সংযুক্ত কিনা তা নির্দেশ করে পতাকা৷

  • স্থানীয় ঠিকানা

    স্ট্রিং ঐচ্ছিক

    অন্তর্নিহিত সকেট সংযুক্ত থাকলে, এর স্থানীয় IPv4/6 ঠিকানা ধারণ করে।

  • স্থানীয় পোর্ট

    সংখ্যা ঐচ্ছিক

    অন্তর্নিহিত সকেট সংযুক্ত থাকলে, তার স্থানীয় পোর্ট ধারণ করে।

  • নাম

    স্ট্রিং ঐচ্ছিক

    সকেটের সাথে যুক্ত অ্যাপ্লিকেশন-সংজ্ঞায়িত স্ট্রিং।

  • বিরতি দেওয়া

    বুলিয়ান

    একটি সংযুক্ত সকেট তার সহকর্মীকে আরও ডেটা পাঠাতে বাধা দেয় কিনা তা নির্দেশ করে ফ্ল্যাগ ( setPaused দেখুন)।

  • পিয়ার ঠিকানা

    স্ট্রিং ঐচ্ছিক

    অন্তর্নিহিত সকেট সংযুক্ত থাকলে, পিয়ার/ IPv4/6 ঠিকানা ধারণ করে।

  • পিয়ারপোর্ট

    সংখ্যা ঐচ্ছিক

    অন্তর্নিহিত সকেট সংযুক্ত থাকলে, পিয়ার পোর্ট ধারণ করে।

  • অবিরাম

    বুলিয়ান

    অ্যাপ্লিকেশন স্থগিত করার সময় সকেট খোলা রাখা হয়েছে কিনা তা নির্দেশ করে ফ্ল্যাগ ( SocketProperties.persistent দেখুন)।

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

SocketProperties

বৈশিষ্ট্য

  • বাফার সাইজ

    সংখ্যা ঐচ্ছিক

    ডেটা গ্রহণ করতে ব্যবহৃত বাফারের আকার। ডিফল্ট মান হল 4096।

  • নাম

    স্ট্রিং ঐচ্ছিক

    সকেটের সাথে যুক্ত একটি অ্যাপ্লিকেশন-সংজ্ঞায়িত স্ট্রিং।

  • অবিরাম

    বুলিয়ান ঐচ্ছিক

    অ্যাপ্লিকেশানের ইভেন্ট পৃষ্ঠাটি আনলোড করার সময় সকেটটি খোলা রেখে দেওয়া হয় কিনা তা নির্দেশ করে ( অ্যাপ লাইফসাইকেল পরিচালনা করুন দেখুন)। ডিফল্ট মান হল "মিথ্যা।" যখন অ্যাপ্লিকেশনটি লোড করা হয়, যে কোন সকেট পূর্বে persistent=true দিয়ে খোলা হয়েছিল getSockets দিয়ে আনা যেতে পারে।

TLSVersionConstraints

বৈশিষ্ট্য

  • সর্বোচ্চ

    স্ট্রিং ঐচ্ছিক

  • মিনিট

    স্ট্রিং ঐচ্ছিক

    TLS এর সর্বনিম্ন এবং সর্বাধিক গ্রহণযোগ্য সংস্করণ। সমর্থিত মান হল tls1.2 বা tls1.3 ।

    tls1 এবং tls1.1 মান আর সমর্থিত নয়। যদি min এই মানগুলির একটিতে সেট করা হয়, তাহলে এটি চুপচাপ tls1.2 এ আটকে থাকবে। যদি max এই মানগুলির একটিতে সেট করা হয়, বা অন্য কোনো অস্বীকৃত মান, এটি নীরবে উপেক্ষা করা হবে।

পদ্ধতি

close()

প্রতিশ্রুতি
chrome.sockets.tcp.close(
  socketId: number,
  callback?: function,
)

সকেট বন্ধ করে এবং সকেটটি আবদ্ধ ঠিকানা/পোর্ট প্রকাশ করে। তৈরি করা প্রতিটি সকেট ব্যবহারের পরে বন্ধ করা উচিত। ফাংশনে কল করার সাথে সাথে সকেট আইডি আর বৈধ থাকে না। যাইহোক, কলব্যাক আহ্বান করা হলেই সকেট বন্ধ হওয়ার নিশ্চয়তা।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

connect()

chrome.sockets.tcp.connect(
  socketId: number,
  peerAddress: string,
  peerPort: number,
  dnsQueryType?: DnsQueryType,
  callback: function,
)

একটি দূরবর্তী মেশিনে সকেট সংযোগ করে। connect অপারেশন সফলভাবে সম্পন্ন হলে, পিয়ার থেকে ডেটা প্রাপ্ত হলে onReceive ইভেন্টগুলি উত্থাপিত হয়। রানটাইম প্যাকেটগুলি গ্রহণ করার সময় যদি একটি নেটওয়ার্ক ত্রুটি ঘটে, একটি onReceiveError ইভেন্ট উত্থাপিত হয়, যে সময়ে resume পদ্ধতিটি কল না করা পর্যন্ত এই সকেটের জন্য আর কোন onReceive ইভেন্ট উত্থাপিত হবে না।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • পিয়ার ঠিকানা

    স্ট্রিং

    রিমোট মেশিনের ঠিকানা। DNS নাম, IPv4 এবং IPv6 ফরম্যাট সমর্থিত।

  • পিয়ারপোর্ট

    সংখ্যা

    দূরবর্তী মেশিনের পোর্ট।

  • dnsQuery টাইপ

    DnsQueryType ঐচ্ছিক

    Chrome 103+

    ঠিকানা সমাধান পছন্দ.

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (result: number) => void

    • ফলাফল

      সংখ্যা

      অন্তর্নিহিত নেটওয়ার্ক কল থেকে ফলাফল কোড ফিরে এসেছে। একটি নেতিবাচক মান একটি ত্রুটি নির্দেশ করে।

create()

প্রতিশ্রুতি
chrome.sockets.tcp.create(
  properties?: SocketProperties,
  callback?: function,
)

একটি TCP সকেট তৈরি করে।

পরামিতি

  • বৈশিষ্ট্য

    SocketProperties ঐচ্ছিক

    সকেট বৈশিষ্ট্য (ঐচ্ছিক)।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (createInfo: CreateInfo) => void

রিটার্নস

  • প্রতিশ্রুতি< CreateInfo >

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

disconnect()

প্রতিশ্রুতি
chrome.sockets.tcp.disconnect(
  socketId: number,
  callback?: function,
)

সকেট সংযোগ বিচ্ছিন্ন করে।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

getInfo()

প্রতিশ্রুতি
chrome.sockets.tcp.getInfo(
  socketId: number,
  callback?: function,
)

প্রদত্ত সকেটের অবস্থা পুনরুদ্ধার করে।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (socketInfo: SocketInfo) => void

রিটার্নস

  • প্রতিশ্রুতি< সকেট ইনফো >

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

getSockets()

প্রতিশ্রুতি
chrome.sockets.tcp.getSockets(
  callback?: function,
)

অ্যাপ্লিকেশনের মালিকানাধীন বর্তমানে খোলা সকেটের তালিকা পুনরুদ্ধার করে।

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (socketInfos: SocketInfo[]) => void

    • সকেট ইনফোস

      সকেট তথ্য [ ]

      সকেট তথ্য ধারণকারী বস্তুর অ্যারে।

রিটার্নস

  • প্রতিশ্রুতি< SocketInfo []>

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

secure()

chrome.sockets.tcp.secure(
  socketId: number,
  options?: SecureOptions,
  callback: function,
)

সংযুক্ত TCP ক্লায়েন্ট সকেটে একটি TLS ক্লায়েন্ট সংযোগ শুরু করুন।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    ব্যবহার করার জন্য বিদ্যমান, সংযুক্ত সকেট।

  • বিকল্প

    SecureOptions ঐচ্ছিক

    TLS সংযোগের জন্য সীমাবদ্ধতা এবং পরামিতি।

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (result: number) => void

    • ফলাফল

      সংখ্যা

send()

chrome.sockets.tcp.send(
  socketId: number,
  data: ArrayBuffer,
  callback: function,
)

প্রদত্ত TCP সকেটে ডেটা পাঠায়।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • তথ্য

    অ্যারেবাফার

    ডেটা পাঠাতে হবে।

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (sendInfo: SendInfo) => void

setKeepAlive()

chrome.sockets.tcp.setKeepAlive(
  socketId: number,
  enable: boolean,
  delay?: number,
  callback: function,
)

একটি TCP সংযোগের জন্য জীবিত রাখা কার্যকারিতা সক্ষম বা নিষ্ক্রিয় করে।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • সক্ষম

    বুলিয়ান

    সত্য হলে, কিপ-লাইভ কার্যকারিতা সক্রিয় করুন।

  • বিলম্ব

    সংখ্যা ঐচ্ছিক

    প্রাপ্ত শেষ ডেটা প্যাকেট এবং প্রথম কিপলাইভ প্রোবের মধ্যে বিলম্ব সেকেন্ড সেট করুন। ডিফল্ট 0।

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (result: number) => void

    • ফলাফল

      সংখ্যা

      অন্তর্নিহিত নেটওয়ার্ক কল থেকে ফলাফল কোড ফিরে এসেছে। একটি নেতিবাচক মান একটি ত্রুটি নির্দেশ করে।

setNoDelay()

chrome.sockets.tcp.setNoDelay(
  socketId: number,
  noDelay: boolean,
  callback: function,
)

একটি TCP সংযোগের জন্য TCP_NODELAY সেট বা সাফ করে। TCP_NODELAY সেট করা হলে Nagle এর অ্যালগরিদম অক্ষম করা হবে৷

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • কোন বিলম্ব

    বুলিয়ান

    সত্য হলে, Nagle এর অ্যালগরিদম নিষ্ক্রিয় করে।

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (result: number) => void

    • ফলাফল

      সংখ্যা

      অন্তর্নিহিত নেটওয়ার্ক কল থেকে ফলাফল কোড ফিরে এসেছে। একটি নেতিবাচক মান একটি ত্রুটি নির্দেশ করে।

setPaused()

প্রতিশ্রুতি
chrome.sockets.tcp.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
)

অ্যাপ্লিকেশানটিকে তার সমবয়সীদের থেকে বার্তাগুলি গ্রহণ করা থেকে সক্ষম বা অক্ষম করে৷ ডিফল্ট মান হল "false"। একটি সকেট বিরাম দেওয়া সাধারণত একটি অ্যাপ্লিকেশন দ্বারা তার সহকর্মী দ্বারা পাঠানো ডেটা থ্রোটল করার জন্য ব্যবহার করা হয়। যখন একটি সকেট বিরাম দেওয়া হয়, তখন কোনো onReceive ইভেন্ট উত্থাপিত হয় না। যখন একটি সকেট সংযুক্ত থাকে এবং বিরতিমুক্ত করা হয়, তখন বার্তাগুলি প্রাপ্ত হলে onReceive ইভেন্টগুলি আবার উত্থাপিত হয়।

পরামিতি

  • সকেট আইডি

    সংখ্যা

  • বিরতি দেওয়া

    বুলিয়ান

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

update()

প্রতিশ্রুতি
chrome.sockets.tcp.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
)

সকেট বৈশিষ্ট্য আপডেট করে।

পরামিতি

  • সকেট আইডি

    সংখ্যা

    সকেট শনাক্তকারী।

  • বৈশিষ্ট্য

    সকেট প্রোপার্টি

    বৈশিষ্ট্য আপডেট করার জন্য.

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 121+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মকে কলব্যাক ব্যবহার করতে হবে।

ঘটনা

onReceive

chrome.sockets.tcp.onReceive.addListener(
  callback: function,
)

একটি প্রদত্ত সকেটের জন্য ডেটা প্রাপ্ত হলে ইভেন্ট উত্থাপিত হয়।

পরামিতি

onReceiveError

chrome.sockets.tcp.onReceiveError.addListener(
  callback: function,
)

রানটাইম সকেট ঠিকানা এবং পোর্টে ডেটার জন্য অপেক্ষা করার সময় নেটওয়ার্ক ত্রুটি দেখা দিলে ইভেন্ট উত্থাপিত হয়৷ একবার এই ইভেন্টটি উত্থাপিত হলে, সকেটটি paused সেট করা হয় এবং এই সকেটের জন্য আর কোন onReceive ইভেন্ট উত্থাপিত হয় না।

পরামিতি