الفرق بين المراجعتين لصفحة: «JavaScript/Document/lastModified»

المراجعة الحالية بتاريخ 03:51، 22 مارس 2018

تُعيد الخاصية document.lastModified سلسلةً نصيةً تحتوي على تاريخ ووقتِ آخر تعديلٍ للمُستند الحاليّ.

البنية العامة

string = document.lastModified;

مثال

طريقة الاستعمال البسيطة:

alert(document.lastModified); 
// يُعيد تاريخا مُشابها لما يلي
// 03/22/2018 05:20:48

تحويل قيمة lastModified إلى كائن من النّوع Date:

var oLastModif = new Date(document.lastModified);

تحويل قيمة lastModified إلى عدد الأجزاء من ألف جزء من الثّانيّة التّي مرّت منذ 1 يناير 1970 على السّاعة 00:00:00:

var nLastModif = Date.parse(document.lastModified);

ملاحظات

لاحظ بأنّه لا يُمكن استعمال السّلسة النّصيّة التي تُعيدها الخاصيّة lastModified من أجل المُقارنة بين تواريخِ تعديل المُستندات بسهولة.

إليك مثالا لكيفيّة عرض نافذة تنبيهٍ عندما تُعدَّل الصّفحة (انظر أيضًا: ملفّات الارتباط في JavaScript):

if (Date.parse(document.lastModified) > parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1") || "0")) {
    document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname;
    alert("لقد عُدّلت هذه الصّفحة");
}

نفسُ المثال مع تجاهل أوّل زيارة:

var

    nLastVisit = parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1")),
    nLastModif = Date.parse(document.lastModified);

if (isNaN(nLastVisit) || nLastModif > nLastVisit) {
    document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname;
    if (isFinite(nLastVisit)) {
        alert("لقد عُدّلت هذه الصّفحة");
    }
}

مُلاحظة: المُتصفّحات التي تعمل بمُحرِّك WebKit (مثل Chrome وSafari) تُعيد التوقيت بصيغة UTC، أمّا Firefox وInternet Explorer فتُعيد السّلسة بصيغة التوقيت المحليّ.

مصادر ومواصفات

مواصفة HTML5.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:<code>Document.lastModified</code>}}</noinclude>
-تُعيد سلسلةً نصيةً تحتوي على تاريخ ووقتِ آخر تعديلٍ للمُستند الحاليّ.
+تُعيد الخاصية <code>document.lastModified</code> سلسلةً نصيةً تحتوي على تاريخ ووقتِ آخر تعديلٍ للمُستند الحاليّ.
 ==البنية العامة==
@@ سطر 12: / سطر 12: @@
 alert(document.lastModified);
 // يُعيد تاريخا مُشابها لما يلي
-// Tuesday, July 10, 2001 10:19:42
+// 03/22/2018 05:20:48
 </syntaxhighlight>
-تحويل قيمة lastModified إلى كائن من النّوع Date:
+تحويل قيمة <code>lastModified</code> إلى كائن من النّوع <code>[[JavaScript/Date|Date]]</code>:
 <syntaxhighlight lang="javascript">
 var oLastModif = new Date(document.lastModified);
 </syntaxhighlight>
-تحويل قيمة lastModified إلى عدد الأجزاء من ألف جزء من الثّانيّة منذ 1 يناير 1970 على السّاعة 00:00:00:
+تحويل قيمة <code>lastModified</code> إلى عدد الأجزاء من ألف جزء من الثّانيّة التّي مرّت منذ 1 يناير 1970 على السّاعة 00:00:00:
 <syntaxhighlight lang="javascript">
 var nLastModif = Date.parse(document.lastModified);
@@ سطر 24: / سطر 24: @@
 ==ملاحظات==
-لاحظ بأنّه لا يُمكن استعمال السّلسة النّصيّة التي تُعيدها الخاصيّة lastModified من أجل المُقارنة بين تواريخِ تعديل المُستندات بسهولة. إليك مثالا لكيفيّة عرض نافذة تنبيه عندما تُعدَّل الصّفحة (انظر أيضًا: ملفّات الارتباط في JavaScript):
+لاحظ بأنّه لا يُمكن استعمال السّلسة النّصيّة التي تُعيدها الخاصيّة <code>lastModified</code> من أجل المُقارنة بين تواريخِ تعديل المُستندات بسهولة.
+إليك مثالا لكيفيّة عرض نافذة تنبيهٍ عندما تُعدَّل الصّفحة (انظر أيضًا: [[JavaScript/Document/cookie|ملفّات الارتباط في JavaScript]]):
 <syntaxhighlight lang="javascript">
 if (Date.parse(document.lastModified) > parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1") || "0")) {
@@ سطر 47: / سطر 49: @@
 مُلاحظة: المُتصفّحات التي تعمل بمُحرِّك  WebKit (مثل Chrome وSafari) تُعيد التوقيت بصيغة UTC، أمّا Firefox وInternet Explorer فتُعيد السّلسة بصيغة التوقيت المحليّ.
-إن أردت أن تعرف ما إذا كانت صفحة خارجيّة قد تغيّرت أو لا، فانظر [[JavaScript/XMLHttpRequest]].
 ==مصادر ومواصفات==
 * مواصفة HTML5.