Atomics : méthode statique pause()

Syntaxe

Atomics.pause() Atomics.pause(durationHint) 

Paramètres

durationHint Facultatif

Un entier que l'implémentation peut utiliser pour déterminer la durée d'attente. Pour une valeur n + 1, une implémentation attend au moins aussi longtemps que pour la valeur n. Ce nombre n'a pas de signification physique précise. Il peut exister une limite interne sur la durée maximale de pause de l'ordre de dizaines à centaines de nanosecondes. Ce paramètre peut être utilisé pour implémenter une backoff strategy en augmentant la valeur passée dans durationHint. Aucune garantie n'existe quant à l'utilisation effective de cet indice par l'implémentation.

Valeur de retour

Aucune (undefined).

Exceptions

TypeError

Levée si durationHint n'est ni un entier ni undefined.

Exemples

Utilisation de pause()

Appeler Atomics.wait() ou Atomics.waitAsync() pour attendre l'accès à une mémoire partagée entraîne la mise hors du cœur du fil d'exécution, puis son retour après l'attente. Cela est efficace en période de forte contention, où l'accès à la mémoire partagée peut prendre un certain temps. Lorsque la contention est faible, il est souvent plus efficace de sonder le verrou sans céder le fil d'exécution : cette approche est connue sous le nom d'attente active ou de verrou tournant. La méthode pause() permet d'effectuer l'attente active de manière plus efficace en fournissant au processeur un indice sur ce que fait le fil d'exécution, et donc sur son faible besoin en ressources.

Pour couvrir les deux cas, une approche courante consiste d'abord à effectuer une attente active en espérant que la contention est faible, puis à attendre si le verrou n'est pas acquis après un court laps de temps. Si le verrou a déjà été acquis via l'attente active, l'appel à wait() sera une opération sans effet.

L'exemple ci-dessous montre comment utiliser Atomics.pause() et Atomics.wait().

// Imaginez qu'un autre processus a aussi accès à cette mémoire partagée const sab = new SharedArrayBuffer(1024); const i32 = new Int32Array(sab); // Voie rapide : faire tourner le processeur un court instant let spin = 0; do { if (Atomics.compareExchange(i32, 0, 0, 1) === 0) { break; } Atomics.pause(); spin++; } while (spin < 10); // Voie lente : attendre le verrou // Cela ne peut être appelé que dans un worker, // car le processus principal ne peut pas être bloqué Atomics.wait(i32, 0, 1); 

Stratégies de suspension

Le paramètre durationHint peut être utilisé pour implémenter des stratégies de suspension. Par exemple, un processus peut commencer avec un indice faible et l'augmenter de manière exponentielle à chaque itération. Cela est préférable à l'appel répété de pause() parce que, dans du code non soumis au JIT, les appels de fonction ont eux-mêmes un coût important.

// Suspension exponentiel for (let hint = 1; hint < 1000; hint *= 2) { Atomics.pause(hint); } // Suspension linéaire for (let hint = 1; hint < 100; hint++) { Atomics.pause(hint); } 

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Atomics
• La méthode Atomics.wait()
• La méthode Atomics.waitAsync()