aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/console/countreset/index.md
blob: 26da32c5f248c4116bc92485c9b22d8f51379ff3 (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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
---
title: Console.countReset()
slug: Web/API/Console/countReset
translation_of: Web/API/Console/countReset
---
{{APIRef("Console API")}}

Remet le compteur à zero. Cette fonction prend un argument optionnel `label`

{{AvailableInWorkers}}

## Syntax

    console.countReset([label]);

### Parameters

- `label`
  - : Si specifié, `countReset()` remet à zero le compteur associé à ce label. S'il n'est pas specifié, `countReset()` remet à zéro le compteur par defaut.

### Return value

Si le paramètre label à été spécifié :

     counter-name: 0

Si aucun label n'as été specifié

    default: 0

### Warnings

Si `label` est specifié mais n'existe pas `countReset()` renvoie cet avertissement :

    Counter "counter-name" doesn’t exist.

Si `label` n'est pas specifé et que `count()` n'as pas encore été appellé `countReset()` renvoie cette avertissement :

    Counter "default" doesn’t exist.

## Examples

Par exemple avec un code comme celui ci :

```js
var user = "";

function greet() {
  console.count();
  return "hi " + user;
}

user = "bob";
greet();
user = "alice";
greet();
greet();
console.count();
console.countReset();
```

Le retour de la console ressemblera à ceci :

    "default: 1"
    "default: 2"
    "default: 3"
    "default: 1"
    "default: 0"

Pour information l'appel à `console.counterReset()` remet à zero la valeur du compteur par défaut.

S'il on passe la variable `user` comme argument pour `label` et que l'on effectue un premier appel de la fonction `count()`, avec la chaine "bob" puis un second appel avec la chaine "alice" :

```js
var user = "";

function greet() {
  console.count(user);
  return "hi " + user;
}

user = "bob";
greet();
user = "alice";
greet();
greet();
console.countReset("bob");
console.count("alice");
```

On obtiendra ce retour dans la console

    "bob: 1"
    "alice: 1"
    "alice: 2"
    "bob: 0"
    "alice: 3"

Remettre à zero le compteur "bob" change uniquement la valeur de celui-ci. La valeur du compteur "alice" reste inchangée.

## Specifications

| Specification                                                                    | Status                           | Comment            |
| -------------------------------------------------------------------------------- | -------------------------------- | ------------------ |
| {{SpecName("Console API", "#count", "console.countReset()")}} | {{Spec2("Console API")}} | Initial definition |

## Browser compatibility

{{Compat("api.Console.countReset")}}