HOWTO · Angular
Cómo copiar con angular.copy en AngularJS
Este tutorial explica cómo usar angular.copy para hacer copias profundas en AngularJS.
En esta página
angular.copy es una API de AngularJS que permite copiar un valor, normalmente un objeto o un array, para que los cambios en la copia no alteren el original por compartir referencias a objetos anidados. Esta guía explica sus dos formas de llamada y un patrón para trabajar con el estado de un formulario. Trata sobre AngularJS; Angular moderno no incluye esta API de AngularJS.
Cómo funciona la copia profunda de angular.copy
Una copia superficial crea un objeto externo nuevo, pero puede dejar compartidos los objetos anidados. Una copia profunda copia los datos anidados de forma recursiva, por lo que cambiar una propiedad anidada de la copia no cambia esa propiedad en el origen. Conviene entenderlo como un estado de objeto independiente; una copia profunda no garantiza una disposición física concreta en memoria.
Por ejemplo, si source.profile es un objeto, después de copy = angular.copy(source), cambiar copy.profile.name deja intacto source.profile.name. Esto resulta útil cuando un formulario o editor necesita una versión de trabajo de los datos y, a la vez, una línea base independiente para restablecer el estado.
Copiar sin un destino
Llama a angular.copy(source) con un argumento para crear y devolver una copia nueva. Guarda el valor devuelto; por ejemplo: var savedForm = angular.copy($scope.form);. El original sigue disponible como origen, mientras que savedForm puede servir como instantánea para compararla más adelante o restablecer el formulario.
El siguiente ejemplo de referencia ejecutable en JavaScript muestra por qué el estado anidado necesita una copia independiente. Usa la operación structuredClone del lenguaje, no AngularJS, así que su salida demuestra únicamente el comportamiento de las referencias y no prueba angular.copy.
Ejecuta este ejemplo de referencia en JavaScript. Su salida muestra primero Mina para el origen y luego Lee para la copia; el código y esos nombres se conservan en inglés en los bloques inmutables.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
const source = { profile: { name: "Mina" } };
const copy = structuredClone(source);
copy.profile.name = "Lee";
console.log(source.profile.name);
console.log(copy.profile.name);
Mina
Lee
Copiar en un destino existente
Usa angular.copy(source, destination) cuando otra parte de la aplicación deba conservar la identidad del objeto de destino. AngularJS copia los datos del origen en ese destino y lo devuelve. Esto resulta útil cuando una propiedad del ámbito u otro consumidor ya tiene una referencia al objeto de destino. Por ejemplo, angular.copy($scope.form, savedForm) actualiza el objeto guardado con los datos del formulario actual y conserva la referencia savedForm.
Las dos formas tienen propósitos distintos: la llamada con un argumento proporciona un valor nuevo para guardar; la llamada con dos argumentos actualiza un objeto que ya tienes. Evita asignar un objeto recién devuelto si otro código depende de la referencia al destino existente.
Restablecer y guardar el estado del formulario
Guarda una instantánea cuando se inicialice el formulario: var savedForm = angular.copy($scope.form);. Para restablecer los campos y conservar el objeto del formulario existente, usa angular.copy(savedForm, $scope.form). Para actualizar la línea base guardada con las ediciones actuales del usuario, usa angular.copy($scope.form, savedForm). El primer argumento siempre es el origen y el segundo, el destino; si inviertes el orden, también inviertes la dirección de la copia.
La ilustración muestra un campo de nombre con botones para restablecer y guardar, junto a los valores mostrados del formulario y del miembro. Esos valores ayudan a entender la relación de estado que pretende mostrar el ejemplo; no son el resultado de ejecutar AngularJS.
Limitaciones y valores no admitidos
No uses el mismo objeto como ambos argumentos: angular.copy(value, value) no es una llamada de copia sobre sí mismo admitida. Si usas la forma con dos argumentos, pasa un destino distinto. Esa forma también modifica el destino: el código que conserve una referencia a ese destino verá su contenido actualizado.
El material proporcionado no incluye un resultado de ejecución de AngularJS ni una referencia autorizada de la API. Por ello, este artículo no generaliza su comportamiento para todos los tipos de valores de JavaScript ni para todos los objetos gestionados por el framework. Consulta la documentación de la versión de AngularJS que utiliza tu aplicación antes de depender de cómo copia valores especiales. El ejemplo de referencia ejecutable anterior es explícitamente una demostración de JavaScript, no una prueba de que se haya ejecutado una llamada a AngularJS.