diff options
Diffstat (limited to 'files/pl/web/javascript/referencje/obiekty/object/assign')
| -rw-r--r-- | files/pl/web/javascript/referencje/obiekty/object/assign/index.html | 307 |
1 files changed, 0 insertions, 307 deletions
diff --git a/files/pl/web/javascript/referencje/obiekty/object/assign/index.html b/files/pl/web/javascript/referencje/obiekty/object/assign/index.html deleted file mode 100644 index 81e764456a..0000000000 --- a/files/pl/web/javascript/referencje/obiekty/object/assign/index.html +++ /dev/null @@ -1,307 +0,0 @@ ---- -title: Object.assign() -slug: Web/JavaScript/Referencje/Obiekty/Object/assign -translation_of: Web/JavaScript/Reference/Global_Objects/Object/assign ---- -<div>{{JSRef}}</div> - -<p>Metoda <strong><code>Object.assign()</code></strong> kopiuje wszystkie wartości wyliczalnych własnych właściwości z jednego lub więcej obiektów źródłowych do obiektu docelowego. Zwraca obiekt docelowy.</p> - -<h2 id="Składnia">Składnia</h2> - -<pre class="syntaxbox">Object.assign(<var>cel</var>, ...<var>zrodla</var>)</pre> - -<h3 id="Parameters">Parameters</h3> - -<dl> - <dt><code>cel</code></dt> - <dd>Obiekt docelowy.</dd> - <dt><code>zrodla</code></dt> - <dd>Obiekt(y) żródłowe.</dd> -</dl> - -<h3 id="Zwracana_wartość">Zwracana wartość</h3> - -<p>Obiekt docelowy.</p> - -<h2 id="Opis">Opis</h2> - -<p>Właściwości w obiekcie docelowym zostaną nadpisane właściwościami obiektów źródłowych, jeśli właściwości te mają takie same nazwy. Właściwości obiektów źródłowych występujących później na liście argumentów, podobnie, nadpiszą właściwości obiektów występujących wcześniej.</p> - -<p>Metoda <code>Object.assign()</code> jedynie kopiuje <em>wyliczalne</em> i <em>własne</em> właściwości z obiektów źródłowych do obiektu docelowego. Używa do tego <code>[[Get]]</code> na źródle oraz <code>[[Set]]</code> na obiekcie docelowym, więc wywołuje gettery i settery odpowiednich obiektów. Dlatego też mowa tu o <em>przypisaniu</em> właściwości, a nie o ich kopiowaniu czy tworzeniu nowych. Metoda ta może być więc nieodpowiednia do przyłączania nowych właściwości do prototypu, w przypadku gdy źródła przyłączenia zawierają gettery. Do kopiowania definicji właściwości, wliczając ich wyliczalność, do prototypów należy użyć {{jsxref("Object.getOwnPropertyDescriptor()")}} oraz {{jsxref("Object.defineProperty()")}}.</p> - -<p>Obie właściwości {{jsxref("String")}} jak i {{jsxref("Symbol")}} są kopiowane.</p> - -<p>W przypadku błędu, na przykład gdy wartość jest zabezpieczona przed zapisem, zostanie rzucony błąd {{jsxref("TypeError")}}, a obiekt docelowy może zostać zmieniony, jeśli jakieś właściwości zostały do niego dodane przed wystąpieniem błędu.</p> - -<p>Zauważ, że <code>Object.assign()</code> nie rzuci błędu, gdy źródłem jest {{jsxref("null")}} lub {{jsxref("undefined")}}.</p> - -<h2 id="Przykłady">Przykłady</h2> - -<h3 id="Klonowanie_obiektu">Klonowanie obiektu</h3> - -<pre class="brush: js">var obiekt = { a: 1 }; -var kopia = Object.assign({}, obiekt); -console.log(kopia); // { a: 1 } -</pre> - -<h3 id="Deep_Clone" name="Deep_Clone">Ostrzeżenie przed Głębokim Klonowaniem</h3> - -<p>W przypadku głębokiego klonowania musimy użyć innych sposóbów, ponieważ <code>Object.assign()</code> kopiuje jedynie wartości przechowywane we właściwościach. Jeżeli właściwość źródłowa jest referencją do obiektu, to skopiowana zostanie jedynie ta referencja (wówczas zarówno źródło jak i cel będą posiadać referencję do tego samego obiektu, a nie osobne kopie tych obiektów).</p> - -<pre><code>function test() { - 'use strict'; - - let obj1 = { a: 0 , b: { c: 0}}; // a: wartość, b: referencja, c: wartość - let obj2 = Object.assign({}, obj1); - console.log(JSON.stringify(obj2)); // { a: 0, b: { c: 0}} - - obj1.a = 1; // zmiana wartości, dotyczy tylko obj1 - console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 0}} - console.log(JSON.stringify(obj2)); // { a: 0, b: { c: 0}} - - obj2.a = 2; // zmiana wartości, dotyczy tylko obj2 - console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 0}} - console.log(JSON.stringify(obj2)); // { a: 2, b: { c: 0}} - - obj2.b.c = 3; // zmiana wartości w obiekcie o współdzielonej referencji - console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 3}} // teraz b.c == 3 - console.log(JSON.stringify(obj2)); // { a: 2, b: { c: 3}} // i tu też b.c == 3, bo obj1.b === obj2.b - - // Klonowanie głębokie - obj1 = { a: 0 , b: { c: 0}}; - let obj3 = JSON.parse(JSON.stringify(obj1)); - obj1.a = 4; - obj1.b.c = 4; - console.log(JSON.stringify(obj3)); // { a: 0, b: { c: 0}} // obj1.b !== obj2.b -} - -test();</code></pre> - -<h3 id="Łączenie_obiektów">Łączenie obiektów</h3> - -<pre class="brush: js">var o1 = { a: 1 }; -var o2 = { b: 2 }; -var o3 = { c: 3 }; - -var obj = Object.assign(o1, o2, o3); -console.log(obj); // { a: 1, b: 2, c: 3 } -console.log(o1); // { a: 1, b: 2, c: 3 }, sam obiekt docelowy został zmieniony.</pre> - -<h3 id="Łączenie_obiektów_z_tymi_samymi_właściowściami">Łączenie obiektów z tymi samymi właściowściami</h3> - -<pre class="brush: js">var o1 = { a: 1, b: 1, c: 1 }; -var o2 = { b: 2, c: 2 }; -var o3 = { c: 3 }; - -var obj = Object.assign({}, o1, o2, o3); -console.log(obj); // { a: 1, b: 2, c: 3 }</pre> - -<p>Właściwość jest nadpisywana przez ostatni obiekt w liście parametrów, który ma taką samą właściwość.</p> - -<h3 id="Kopiowanie_właściwości-symboli">Kopiowanie właściwości-symboli</h3> - -<pre class="brush: js">var o1 = { a: 1 }; -var o2 = { [Symbol('foo')]: 2 }; - -var obj = Object.assign({}, o1, o2); -console.log(obj); // { a : 1, [Symbol("foo")]: 2 } (cf. bug 1207182 on Firefox) -Object.getOwnPropertySymbols(obj); // [Symbol(foo)] -</pre> - -<h3 id="Właściwości_nieprzeliczalne_oraz_te_z_łańcucha_prototypów_nie_są_kopiowane">Właściwości nieprzeliczalne oraz te z łańcucha prototypów nie są kopiowane</h3> - -<pre class="brush: js">var obj = Object.create({ foo: 1 }, { // foo jest właściwością prototypu obiektu obj - bar: { - value: 2 // bar jest nieprzeliczalną właściwością - }, - baz: { - value: 3, - enumerable: true // baz jest własną, przeliczalną właściwością obiektu obj - } -}); - -var kopia = Object.assign({}, obj); -console.log(kopia); // { baz: 3 } -</pre> - -<h3 id="Wartości_podstawowe_zostaną_włożone_do_ich_wrapperów">Wartości podstawowe zostaną włożone do ich wrapperów</h3> - -<pre class="brush: js">var v1 = 'abc'; -var v2 = true; -var v3 = 10; -var v4 = Symbol('foo'); - -var obj = Object.assign({}, v1, null, v2, undefined, v3, v4); -// Wartości podstawowe będą we wrapperach, null i undefined zostaną zignorowane. -// Zauważ, że jedynie wrapper string'a ma przeliczalne właściwości: -console.log(obj); // { "0": "a", "1": "b", "2": "c" } -</pre> - -<h3 id="Wyjątki_przerwą_wykonywanie_kopiowania">Wyjątki przerwą wykonywanie kopiowania</h3> - -<pre class="brush: js">var cel = Object.defineProperty({}, 'foo', { - value: 1, - writable: false -}); // cel.foo jest właściwością tylko do odczytu - -Object.assign(cel, { bar: 2 }, { foo2: 3, foo: 3, foo3: 3 }, { baz: 4 }); -// TypeError: "foo" is read-only -// Wyjątek został wyrzucony podczas próby zapisania cel.foo - -console.log(cel.bar); // 2, pierwsze źródło zostało skopiowane pomyślnie -console.log(cel.foo2); // 3, pierwsza właściwość drugiego źródła zostało skopiowana pomyślnie -console.log(cel.foo); // 1, tutaj został wyrzucony wyjątek -console.log(cel.foo3); // undefined, kopiowanie dobiegło końca, foo3 nie zostanie skopiowane -console.log(cel.baz); // undefined, trzecie źródło również nie zostanie skopiowane -</pre> - -<h3 id="Kopiowanie_operatorów_pamięci">Kopiowanie operatorów pamięci</h3> - -<pre class="brush: js">var obj = { - foo: 1, - get bar() { - return 2; - } -}; - -var kopia = Object.assign({}, obj); -console.log(kopia); -// { foo: 1, bar: 2 }, wartość kopia.bar jest wartością zwracaną przez metodę getter właściwości obj.bar - -// Funkcja przypisania kopiująca całe deskryptory: -function completeAssign(cel, ...zrodla) { - zrodla.forEach(zrodlo => { - let deskryptory = Object.keys(zrodlo).reduce((deskryptory, klucz) => { - deskryptory[klucz] = Object.getOwnPropertyDescriptor(zrodlo, klucz); - return deskryptory; - }, {}); - // domyślnie Object.assign kopiuje również przeliczalne symbole - Object.getOwnPropertySymbols(zrodlo).forEach(sym => { - let deskryptor = Object.getOwnPropertyDescriptor(zrodlo, sym); - if (deskryptor.enumerable) { - deskryptory[sym] = deskryptor; - } - }); - Object.defineProperties(cel, deskryptory); - }); - return target; -} - -var kopia = completeAssign({}, obj); -console.log(kopia); -// { foo:1, get bar() { return 2 } } -</pre> - -<h2 id="Polyfill">Polyfill</h2> - -<p>Ten {{Glossary("Polyfill","polyfill")}} nie wspiera właściwości-symboli, ponieważ ES5 i tak ich nie ma.</p> - -<pre class="brush: js">if (typeof Object.assign != 'function') { - Object.assign = function(target, varArgs) { // .length of function is 2 - 'use strict'; - if (target == null) { // TypeError if undefined or null - throw new TypeError('Cannot convert undefined or null to object'); - } - - var to = Object(target); - - for (var index = 1; index < arguments.length; index++) { - var nextSource = arguments[index]; - - if (nextSource != null) { // Skip over if undefined or null - for (var nextKey in nextSource) { - // Avoid bugs when hasOwnProperty is shadowed - if (Object.prototype.hasOwnProperty.call(nextSource, nextKey)) { - to[nextKey] = nextSource[nextKey]; - } - } - } - } - return to; - }; -} -</pre> - -<h2 id="Specyfikacje">Specyfikacje</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-object.assign', 'Object.assign')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-object.assign', 'Object.assign')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Kompatybilność_z_przeglądarką">Kompatybilność z przeglądarką</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Edge</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatChrome("45")}}</td> - <td>{{CompatGeckoDesktop("34")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatOpera("32")}}</td> - <td>{{CompatSafari("9")}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}}</td> - <td>{{CompatChrome("45")}}</td> - <td>{{CompatGeckoMobile("34")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Zobacz_również">Zobacz również</h2> - -<ul> - <li>{{jsxref("Object.defineProperties()")}}</li> - <li><a href="/pl/docs/Web/JavaScript/Enumerability_and_ownership_of_properties">Przeliczalność i własność właściwości</a></li> -</ul> |