---
title: BigInt.prototype.valueOf()
slug: Web/JavaScript/Reference/Objets_globaux/BigInt/valueOf
tags:
  - BigInt
  - JavaScript
  - Method
  - Prototype
  - Reference
  - valueOf()
translation_of: Web/JavaScript/Reference/Global_Objects/BigInt/valueOf
---
<div>{{JSRef}}</div>

<p>La méthode <strong><code>valueOf()</code></strong> renvoie la valeur primitive encapsulée dans un objet {{jsxref("BigInt")}}.</p>

<div>{{EmbedInteractiveExample("pages/js/bigint-valueof.html")}}</div>

<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuer à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p>

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

<pre class="syntaxbox"><var>bigIntObj</var>.valueOf()</pre>

<h3 id="Valeur_de_retour">Valeur de retour</h3>

<p>Un grand entier (<em>big int</em>) représentant la valeur primitive de l'objet {{jsxref("BigInt")}} courant.</p>

<h2 id="Exemples">Exemples</h2>

<h3 id="Utiliser_valueOf()">Utiliser <code>valueOf()</code></h3>

<pre class="brush: js">typeof Object(1n); // object
typeof Object(1n).valueOf(); // bigint
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
  </tr>
  <tr>
   <td><a href="https://tc39.github.io/proposal-bigint/#sec-bigint.prototype.valueof">Proposition pour <code>BigInt</code></a></td>
   <td>Proposition de niveau 3</td>
  </tr>
 </tbody>
</table>

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

<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div>

<p>{{Compat("javascript.builtins.BigInt.valueOf")}}</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>{{jsxref("BigInt.prototype.toString()")}}</li>
</ul>