L’algorithme de clonage structuré
=================================

L'algorithme de clonage structuré est un nouvel algorithme défini par la spécification HTML5 pour sérialiser les objets JavaScript complexes. Il est plus puissant que JSON en cela qu'il supporte la sérialisation d'objets contenant des graphes cycliques — des objets peuvent faire référence à des objets faisant référence à d'autres objets dans le même graphe. De plus, dans certains cas, l'algorithme de clonage structuré peut être plus efficace que JSON.

L'algorithme, essentiellement, parcourt tous les champs de l'objet original, copiant les valeurs de chaque champ dans un nouvel objet. Si un champ est lui-même un objet avec des champs, ces champs sont parcourus de manière récursive jusqu'à ce que chaque champ et sous-champ aient été copié dans le nouvel objet.

Avantages par rapport à JSON
----------------------------

Il y a quelques avantages notables à utiliser l'algorithme de clonage structuré plutôt que JSON :

* Le clonage structuré peut copier des objets `RegExp` (en-US).
* Le clonage structuré peut copier des objets `Blob`, `File` et `FileList`.
* Le clonage structuré peut copier des objets `ImageData`. Les dimensions du `CanvasPixelArray` (en-US) du clone correspondront à celles de l'original, et il recevra une copie des mêmes données de pixels.
* Le clonage structuré copie correctement les objets contenant des graphes de références cycliques.
Ce qui ne marche pas avec le clonage structuré
----------------------------------------------

* Les objets `Error` (en-US) et `Function` (en-US) ne peuvent pas être copiés par l'algorithme de clonage structuré ; toute tentative de le faire émettra une exception `DATA_CLONE_ERR`.
* De la même manière, toute tentative de cloner des nœuds DOM émettra une exception `DATA_CLONE_ERR`.
* Certains paramètres d'objets ne sont pas préservés :
    + Le champ `lastIndex` des objets `RegExp` (en-US) n'est pas préservé.
    + Les descripteurs de propriétés, accesseurs et mutateurs (ainsi que les fonctionnalités de métadonnées similaires) ne sont pas copiés. Par exemple, si un objet est marqué en lecture seule *via* un descripteur de propriété, il sera en lecture et écriture dans le clone, car c'est la condition par défaut.
    + La chaîne de prototypes n'est ni parcourue, ni copiée.
Types supportés
---------------

| Type d'objet | Notes |
| --- | --- |
| Tous types primitifs | À l'exception des symboles |
| Objet Booléen |  |
| Objet String |  |
| Date |  |
| RegExp | Le champ `lastIndex` n'est pas préservé |
| `Blob` |  |
| `File` |  |
| `FileList` |  |
| ArrayBuffer |  |
| ArrayBufferView (en-US) | Ce qui implique tous les tableaux typés tels que `Int32Array`, etc. |
| `ImageData` |  |
| Array |  |
| Object | Inclut seulement les objets plats (par ex. depuis un objet littéral) |
| Map |  |
| Set |  |

Alternative : copie profonde
----------------------------

Si vous voulez une **copie profonde** d'un objet (c'est-à-dire une copie récursive de toutes les propriétés imbriquées, en parcourant la chaîne des prototypes), vous devez employer une autre approche. Ce qui suit est un exemple possible.


```js
function clone(objectToBeCloned) {
  // Cas basique.
  if (!(objectToBeCloned instanceof Object)) {
    return objectToBeCloned;
  }

  var objectClone;

  // Filtre les objets spéciaux.
  var Constructor = objectToBeCloned.constructor;
  switch (Constructor) {
    // Implémenter d’autres objets spéciaux ici.
    case RegExp:
      objectClone = new Constructor(objectToBeCloned);
      break;
    case Date:
      objectClone = new Constructor(objectToBeCloned.getTime());
      break;
    default:
      objectClone = new Constructor();
  }

  // Clone chaque propriété.
  for (var prop in objectToBeCloned) {
    objectClone[prop] = clone(objectToBeCloned[prop]);
  }

  return objectClone;
}
```


**Note :** Cet algorithme ne prend en charge que les objets spéciaux `RegExp` (en-US), `Array` et `Date` (en-US). Vous pouvez implémenter d'autres cas spéciaux selon vos besoins.

Voir aussi
----------

* Spécification HTML5 : Passage sécurisé de données structurées
* `window.history`
* `window.postMessage()`
* Web Workers
* Components.utils.cloneInto