Document.open()
يفتح التّابع Document.open() المستند للكتابة عليه بالتّابع Document.write().
البنية العامة
document.open();
مثال
// تُعاد كتابة محتويات المستند لأنّ المستند يُهيّئ من جديد من طرف التّابع
// open().
document.write("<html><p>احذفني</p></html>");
document.open();
// المستند فارغ
ملاحظات
إن كان المستند موجودًا في الهدف، فسيحذف هذا التّابع محتوياته (انظر المثال أعلاه).
ويُستدعى التّابع Document.open() تلقائيًّا عند استدعاء التّابع Document.write() بعد أن تُحمَّل الصّفحة، لكنّ هذا الأمر غير مُعرّفٍ في مواصفة W3C.
لا تخلط بين هذا التّابع والتّابع window.open()، فالتّابع Document.open() يسمح لك بالكتابة فوق المستند الحالي أو الإضافة إلى آخره، أمّا التّابع window.open() فيوفّر طريقةً لفتح نافذة جديدة، تاركًا المستند الحاليّ سليمًا. ولأنّ الكائن window هو الكائن العمومي، فاستدعاء التّابع open() يقوم بنفس تأثير استدعاء التّابع window.open(). ويمكنك إغلاق المستند المفتوح باستعمال التّابع document.close().
انظر هذه الصّفحة للمزيد عن هذه المبادئ.
إن لم ترغب في إنشاء مُدخلٍ في تاريخ الصّفحة (history entry)، فأبدِل open() بالاستدعاء open("text/html", "replace").
دعم المتصفّحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |