---
title: Document.writeln()
slug: Web/API/Document/writeln
tags:
  - API
  - DOM
  - Method
  - Reference
translation_of: Web/API/Document/writeln
---
<p>{{ ApiRef("DOM") }}</p>

<p>Écrit une chaine de caractères suivie d'un retour de ligne.</p>

<h2 id="Syntax" name="Syntax">Syntaxe</h2>

<pre class="eval notranslate">document.writeln(<em>ligne</em>);
</pre>

<h3 id="Parameters" name="Parameters">Paramètres</h3>

<ul>
 <li><code>ligne</code> est la chaine de caractère contenant le texte.</li>
</ul>

<h2 id="Example" name="Example">Exemple</h2>

<pre class="notranslate">document.writeln("&lt;p&gt;Entrez votre mot de passe :&lt;/p&gt;");
</pre>

<h2 id="Notes" name="Notes">Notes</h2>

<p><strong>document.writeln </strong>est identique à <a href="/en-US/docs/Web/API/Document/write">{{domxref("document.write")}}</a>, mais ajoute une nouvelle ligne.</p>

<div class="note"><strong>Note :</strong> <strong>document.writeln</strong> (comme <strong>document.write</strong>) n'a aucun effet en XHTML documents (vous obtiendrez une erreur "Operation is not supported" (<code>NS_ERROR_DOM_NOT_SUPPORTED_ERR</code>) dans la console). Ceci est le cas si un fichier est ouvert en local avec l'extension .xhtml ou pour tous documents utilisant le type MIME application/xhtml+xml. Pour plus d'informations, visitez <a class="external" href="http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite" title="http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite">W3C XHTML FAQ</a>.</div>

<h2 id="Specification" name="Specification">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td><strong>Spécification</strong></td>
   <td><strong>État</strong></td>
  </tr>
  <tr>
   <td>{{SpecName("HTML WHATWG", "#dom-document-writeln", "document.writeln()")}}</td>
   <td>{{Spec2("HTML WHATWG")}}</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM2 HTML", "html.html#ID-35318390", "document.writeln()")}}</td>
   <td>{{Spec2("DOM2 HTML")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("api.Document.writeln")}}</p>