aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/javascript/reference/operators/void/index.md
blob: a83cd56945afa253e4fba40d181862c589f70243 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
---
title: L'opérateur void
slug: Web/JavaScript/Reference/Operators/void
tags:
  - JavaScript
  - Operator
  - Reference
translation_of: Web/JavaScript/Reference/Operators/void
original_slug: Web/JavaScript/Reference/Opérateurs/L_opérateur_void
---
{{jsSidebar("Operators")}}

L'**opérateur `void`** permet d'évaluer une _expression_ donnée et de renvoyer `undefined`.

{{EmbedInteractiveExample("pages/js/expressions-voidoperator.html")}}

## Syntaxe

    void expression

## Description

Cet opérateur permet d'évaluer des expressions retournant une valeur là où on attend une expression qui vaut {{jsxref("undefined")}}.

L'opérateur `void` est souvent utilisé pour obtenir la valeur `undefined`, généralement avec "`void(0)`" (qui est l'équivalent de "`void 0`"). Pour ce cas d'exemple, on aurait très bien pu utiliser la variable globale {{jsxref("undefined")}}.

Attention à [la précédence des opérateurs](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/Pr%C3%A9c%C3%A9dence_des_op%C3%A9rateurs) et notamment de celle de `void`, si besoin, on pourra utiliser des parenthèses pour clarifier la résolution de l'expression :

```js
void 2 == '2';    // renvoie false
void (2 === '2'); // renvoie undefined
```

## Expressions de fonction appelées immédiatement

Lorsqu'on utilise tout un script dans une fonction qu'on évalue immédiatement, `void` peut être utilisé pour que le mot-clé `function` soit traité comme une expression plutôt que comme une déclaration.

```js
void function iife() {
    var toto = function () {};
    var machin = function () {};
    var truc = function () {
        toto();
        machin();
     };
    var bidule = function () {};

    truc();
    bidule();
}();
```

## Les URI JavaScript

Lorsqu'un navigateur utilise une URI avec `javascript:`, le code de l'URI est évalué et le résultat remplace le contenu de la page, sauf si la valeur renvoyée vaut {{jsxref("Objets_globaux/undefined","undefined")}}. L'utilisateur `void` peut alors être utilisé pour renvoyer cette valeur. Par exemple :

    <a href="javascript:void(0);">
      Cliquer ici (sans effet)
    </a>

    <a href="javascript:void(document.body.style.backgroundColor='green');">
      Cliquer ici pour rendre le fond vert
    </a>

Malgré cela, il n'est pas recommandé d'utiliser le pseudo-protocole `javascript:`, on lui préférera des méthodes moins risquées et moins intrusives comme les gestionnaires d'événements.

## Fonctions fléchées sans valeur de retour

Les fonctions fléchées raccourcissent la syntaxe pour obtenir la valeur d'une fonction avec le résultat d'une expression qui constitue le corps de la fonction. Ainsi, la fonction renvoie nécessairement une valeur. Aussi, convertir une base de code afin d'utiliser des fonctions fléchées peut avoir certains effets de bord lorsqu'on souhaite qu'une fonction soit simplement exécutée mais pas que sa valeur de retour interfère avec le reste.

Pour éviter de transmettre cette valeur de retour, on pourra utiliser l'opérateur `void` :

```js
button.onclick = () => void faireQQc();
```

Ainsi, la valeur de retour de la fonction `faireQQc` sera bloquée par `void` et c'est `undefined` qui sera la valeur de retour de la fonction fléchée. Cela s'avère utile si on change l'API de `faireQQc` par exemple et qu'on souhaite éviter les effets de bord causés par cette modification.

## Spécifications

| Spécification                                                                        | Statut                       | Commentaires                                         |
| ------------------------------------------------------------------------------------ | ---------------------------- | ---------------------------------------------------- |
| {{SpecName('ESDraft', '#sec-void-operator', 'Opérateur void')}} | {{Spec2('ESDraft')}} |                                                      |
| {{SpecName('ES6', '#sec-void-operator', 'L\'opérateur void')}} | {{Spec2('ES6')}}         |                                                      |
| {{SpecName('ES5.1', '#sec-11.4.2', 'L\'opérateur void')}}         | {{Spec2('ES5.1')}}     |                                                      |
| {{SpecName('ES3', '#sec-11.4.2', 'L\'opérateur void')}}         | {{Spec2('ES3')}}         |                                                      |
| {{SpecName('ES1', '#sec-11.4.2', 'L\'opérateur void')}}         | {{Spec2('ES1')}}         | Définition initiale. Implémentée avec JavaScript 1.1 |

## Compatibilité des navigateurs

{{Compat("javascript.operators.void")}}

## Voir aussi

- {{jsxref("undefined")}}