ক্লাস google.script.history (ক্লায়েন্ট-সাইড API)

google.script.history হল একটি অ্যাসিঙ্ক্রোনাস ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট API যা ব্রাউজার ইতিহাস স্ট্যাকের সাথে ইন্টারঅ্যাক্ট করতে পারে। এটি শুধুমাত্র একটি ওয়েব অ্যাপের প্রসঙ্গে ব্যবহার করা যেতে পারে যা IFRAME ব্যবহার করে। এটি একটি অ্যাড-অন বা কন্টেইনার-স্ক্রিপ্ট প্রসঙ্গে সাইডবার এবং ডায়ালগগুলির সাথে ব্যবহারের উদ্দেশ্যে নয়৷ আরও তথ্যের জন্য, ওয়েব অ্যাপে ব্রাউজার ইতিহাস ব্যবহার করার নির্দেশিকা দেখুন।

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
push(stateObject, params, hash) void প্রদত্ত স্টেট অবজেক্ট, ইউআরএল প্যারামিটার এবং ইউআরএল ফ্র্যাগমেন্টকে ব্রাউজার হিস্ট্রি স্ট্যাকের দিকে ঠেলে দেয়।
replace(stateObject, params, hash) void ব্রাউজার ইতিহাস স্ট্যাকের শীর্ষ ইভেন্টকে প্রদত্ত স্টেট অবজেক্ট, ইউআরএল প্যারামিটার এবং ইউআরএল ফ্র্যাগমেন্ট দিয়ে প্রতিস্থাপন করে।
setChangeHandler(function) void ব্রাউজারের ইতিহাসে পরিবর্তনের প্রতিক্রিয়া জানাতে একটি কলব্যাক ফাংশন সেট করে

বিস্তারিত ডকুমেন্টেশন

push(stateObject, params, hash)

প্রদত্ত স্টেট অবজেক্ট, ইউআরএল প্যারামিটার এবং ইউআরএল ফ্র্যাগমেন্টকে ব্রাউজার হিস্ট্রি স্ট্যাকের দিকে ঠেলে দেয়। স্টেট অবজেক্ট হল একটি সাধারণ জাভাস্ক্রিপ্ট অবজেক্ট যা ডেভেলপার দ্বারা সংজ্ঞায়িত করা হয় এবং অ্যাপের বর্তমান অবস্থার সাথে প্রাসঙ্গিক যেকোন ডেটা থাকতে পারে। এই পদ্ধতিটি pushState() JavaScript পদ্ধতির সাথে সাদৃশ্যপূর্ণ।

Index.html 
var now = new Date();
var state = {
  'timestamp': now.getTime()
};
var params = {
  'options': "none"
};
google.script.history.push(state, params, "anchor1");

পরামিতি

নাম টাইপ বর্ণনা
stateObject Object একটি বিকাশকারী-সংজ্ঞায়িত অবজেক্ট একটি ব্রাউজার ইতিহাস ইভেন্টের সাথে যুক্ত হতে হবে এবং যেটি স্টেট পপ করা হলে পুনরুত্থিত হয়৷ সাধারণত ভবিষ্যতে পুনরুদ্ধারের জন্য অ্যাপ্লিকেশন স্টেট তথ্য (যেমন পৃষ্ঠা ডেটা) সংরক্ষণ করতে ব্যবহৃত হয়।
params Object এই অবস্থার সাথে যুক্ত করার জন্য URL প্যারামিটার ধারণকারী একটি বস্তু। উদাহরণস্বরূপ, {foo: “bar”, fiz: “baz”} "?foo=bar&fiz=baz" এর সমতুল্য। বিকল্পভাবে, অ্যারে ব্যবহার করা যেতে পারে: {foo: [“bar”, “cat”], fiz: “baz”} "?foo=bar&foo=cat&fiz=baz" এর সমতুল্য। নাল বা অনির্ধারিত হলে, বর্তমান URL প্যারামিটার পরিবর্তন করা হয় না। খালি থাকলে, URL প্যারামিটারগুলি সাফ করা হয়।
hash String স্ট্রিং URL খণ্ডটি '#' অক্ষরের পরে প্রদর্শিত হচ্ছে। যদি নাল বা অনির্ধারিত হয়, বর্তমান URL খণ্ড পরিবর্তন করা হয় না। খালি থাকলে, URL খণ্ডটি সাফ করা হয়।

replace(stateObject, params, hash)

প্রদত্ত (ডেভেলপার-সংজ্ঞায়িত) স্টেট অবজেক্ট, URL প্যারামিটার এবং URL খণ্ড দিয়ে ব্রাউজার ইতিহাস স্ট্যাকের শীর্ষ ইভেন্ট প্রতিস্থাপন করে। এটি push() এর সাথে অন্যথায় অভিন্ন।

Index.html 
var now = new Date();
var state = {
  'timestamp': now.getTime()
};
var params = {
  'options': "none"
};
google.script.history.replace(state, params, "anchor1");

পরামিতি

নাম টাইপ বর্ণনা
stateObject Object একটি বিকাশকারী-সংজ্ঞায়িত অবজেক্ট একটি ব্রাউজার ইতিহাস ইভেন্টের সাথে যুক্ত হতে হবে এবং যেটি স্টেট পপ করা হলে পুনরুত্থিত হয়৷ সাধারণত ভবিষ্যতে পুনরুদ্ধারের জন্য অ্যাপ্লিকেশন স্টেট তথ্য (যেমন পৃষ্ঠা ডেটা) সংরক্ষণ করতে ব্যবহৃত হয়।
params Object এই অবস্থার সাথে যুক্ত করার জন্য URL প্যারামিটার ধারণকারী একটি বস্তু। উদাহরণস্বরূপ, {foo: “bar”, fiz: “baz”} "?foo=bar&fiz=baz" এর সমতুল্য। বিকল্পভাবে, অ্যারে ব্যবহার করা যেতে পারে: {foo: [“bar”, “cat”], fiz: “baz”} "?foo=bar&foo=cat&fiz=baz" এর সমতুল্য। নাল বা অনির্ধারিত হলে, বর্তমান URL প্যারামিটার পরিবর্তন করা হয় না। খালি থাকলে, URL প্যারামিটারগুলি সাফ করা হয়।
hash String স্ট্রিং URL খণ্ডটি '#' অক্ষরের পরে প্রদর্শিত হচ্ছে। যদি নাল বা অনির্ধারিত হয়, বর্তমান URL খণ্ড পরিবর্তন করা হয় না। খালি থাকলে, URL খণ্ডটি সাফ করা হয়।

setChangeHandler(function)

ব্রাউজারের ইতিহাসে পরিবর্তনের প্রতিক্রিয়া জানাতে একটি কলব্যাক ফাংশন সেট করে। কলব্যাক ফাংশন একটি যুক্তি হিসাবে শুধুমাত্র একটি একক ইভেন্ট অবজেক্ট গ্রহণ করা উচিত.

Index.html 
google.script.history.setChangeHandler(function (e) {
  console.log(e.state);
  console.log(e.location.parameters);
  console.log(e.location.hash);

  // Adjust web app UI to match popped state here...
});

পরামিতি

নাম টাইপ বর্ণনা
function Function একটি ক্লায়েন্ট-সাইড কলব্যাক ফাংশন ইতিহাস পরিবর্তন ইভেন্টের উপর চালানোর জন্য, ইভেন্ট অবজেক্টকে একমাত্র যুক্তি হিসাবে ব্যবহার করে।

ইভেন্ট অবজেক্ট

ক্ষেত্র
e.state

পপড ইভেন্টের সাথে যুক্ত রাষ্ট্রীয় বস্তু। এই অবজেক্টটি স্টেট অবজেক্টের অনুরূপ যা সংশ্লিষ্ট পুশ() বা প্রতিস্থাপন() পদ্ধতিতে ব্যবহৃত হয় যা ইতিহাসের স্ট্যাকে পপড স্টেট যোগ করে।

{"page":2, "name":"Wilbur"}
e.location

পপ করা ইভেন্টের সাথে সম্পর্কিত একটি অবস্থান বস্তু 

{"hash":"", "parameter":{"name": "alice", "n": "1"}, "parameters":{"name": ["alice"], "n": ["1", "2"]}}