क्लास google.script.history (Client-side API)

google.script.history एक एसिंक्रोनस क्लाइंट-साइड JavaScript API है, जो में दी गई जानकारी देख सकते हैं. इसका इस्तेमाल सिर्फ़ उस वेब ऐप्लिकेशन के संदर्भ में किया जा सकता है जो IFRAME. इसे ऐड-ऑन में साइडबार और डायलॉग के साथ इस्तेमाल करने के लिए नहीं बनाया गया है या कंटेनर-स्क्रिप्ट संदर्भ का इस्तेमाल करेगा. ज़्यादा जानकारी के लिए, देखें ब्राउज़र का इस्तेमाल करने के लिए गाइड वेब ऐप्लिकेशन में इतिहास.

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
push(stateObject, params, hash)	void	दिए गए स्थिति ऑब्जेक्ट, यूआरएल पैरामीटर, और यूआरएल फ़्रैगमेंट को ब्राउज़र इतिहास में पुश करता है स्टैक.
replace(stateObject, params, hash)	void	यह नीति, दिए गए स्टेट ऑब्जेक्ट, यूआरएल के साथ ब्राउज़िंग इतिहास स्टैक के मुख्य इवेंट को बदलता है पैरामीटर और यूआरएल फ़्रैगमेंट.
setChangeHandler(function)	void	यह विकल्प ब्राउज़र इतिहास में हुए बदलावों का जवाब देने के लिए, कॉलबैक फ़ंक्शन सेट करता है

विस्तृत दस्तावेज़

push(stateObject, params, hash)

दिए गए स्थिति ऑब्जेक्ट, यूआरएल पैरामीटर, और यूआरएल फ़्रैगमेंट को ब्राउज़र इतिहास में पुश करता है स्टैक. स्टेट ऑब्जेक्ट एक सामान्य JavaScript ऑब्जेक्ट होता है, जिसे डेवलपर तय करता है और यह ऐप्लिकेशन की मौजूदा स्थिति से जुड़ा कोई भी डेटा शामिल होना चाहिए. यह तरीका 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	एक ऑब्जेक्ट, जिसमें इस राज्य से संबद्ध करें. उदाहरण के लिए, {foo: “bar”, fiz: “baz”} इसका मतलब है "?foo=bar&fiz=baz". इसके अलावा, अरे का इस्तेमाल भी किया जा सकता है: {foo: [“bar”, “cat”], fiz: “baz”}, "?foo=bar&foo=cat&fiz=baz" के बराबर है. अगर शून्य या तय नहीं है, तो मौजूदा यूआरएल पैरामीटर में बदलाव नहीं होता है. अगर यूआरएल पैरामीटर खाली होते हैं, तो साफ़ किया.
hash	String	इसके बाद दिखाई देने वाला स्ट्रिंग यूआरएल फ़्रैगमेंट '#' वर्ण. अगर शून्य या तय नहीं है, तो मौजूदा यूआरएल फ़्रैगमेंट में बदलाव नहीं होता है. अगर खाली है, तो यूआरएल फ़्रैगमेंट मिटा दिया गया है.

---

---

replace(stateObject, params, hash)

यह ब्राउज़र इतिहास स्टैक पर मुख्य इवेंट को, डेवलपर की तय की गई स्थिति से बदलता है ऑब्जेक्ट, यूआरएल पैरामीटर, और यूआरएल फ़्रैगमेंट. अन्य मामलों में यह इसके जैसा है 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	एक ऑब्जेक्ट, जिसमें इस राज्य से संबद्ध करें. उदाहरण के लिए, {foo: “bar”, fiz: “baz”} इसका मतलब है "?foo=bar&fiz=baz". इसके अलावा, अरे का इस्तेमाल भी किया जा सकता है: {foo: [“bar”, “cat”], fiz: “baz”}, "?foo=bar&foo=cat&fiz=baz" के बराबर है. अगर शून्य या तय नहीं है, तो मौजूदा यूआरएल पैरामीटर में बदलाव नहीं होता है. अगर यूआरएल पैरामीटर खाली होते हैं, तो साफ़ किया.
hash	String	इसके बाद दिखाई देने वाला स्ट्रिंग यूआरएल फ़्रैगमेंट '#' वर्ण. अगर शून्य या तय नहीं है, तो मौजूदा यूआरएल फ़्रैगमेंट में बदलाव नहीं होता है. अगर खाली है, तो यूआरएल फ़्रैगमेंट मिटा दिया गया है.

---

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	पॉप किए गए इवेंट से जुड़ा स्टेट ऑब्जेक्ट. यह ऑब्जेक्ट, स्टेट के जैसा है ऐसा ऑब्जेक्ट जिसका इस्तेमाल संबंधित push() में किया गया हो या replace() का ऐसा तरीका जिसमें पॉप-अप की गई स्थिति जोड़ी गई हो इतिहास स्टैक में ले जाया जाएगा. {"page":2, "name":"Wilbur"}
e.location	जगह की जानकारी से जुड़ा ऑब्जेक्ट पॉप किए गए इवेंट से जुड़ा है {"hash":"", "parameter":{"name": "alice", "n": "1"}, "parameters":{"name": ["alice"], "n": ["1", "2"]}}

---