From 2d9aded27174a991b3c3a6e981b6a8c827e5ea17 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Fri, 15 Feb 2019 03:35:25 +0300 Subject: [PATCH 01/11] Translate "Don't Call PropTypes Warning" --- content/warnings/dont-call-proptypes.md | 48 ++++++++++++------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 07dfa33f0..218b04777 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -1,20 +1,20 @@ --- -title: Don't Call PropTypes Warning +title: Предупреждение: не вызывайте PropTypes layout: single permalink: warnings/dont-call-proptypes.html --- -> Note: +> Примечание: > -> `React.PropTypes` has moved into a different package since React v15.5. Please use [the `prop-types` library instead](https://www.npmjs.com/package/prop-types). +> С версии React 15.5 `React.PropTypes` были вынесены в отдельный пакет. Так что используйте [библиотеку `prop-types`](https://www.npmjs.com/package/prop-types). > ->We provide [a codemod script](/blog/2017/04/07/react-v15.5.0.html#migrating-from-react.proptypes) to automate the conversion. +> Вы можете использовать [codemod-скрипт](/blog/2017/04/07/react-v15.5.0.html#migrating-from-reactproptypes), чтобы провести замену в коде на использование этой библиотеки. -In a future major release of React, the code that implements PropType validation functions will be stripped in production. Once this happens, any code that calls these functions manually (that isn't stripped in production) will throw an error. +В следующем мажорном релизе React, если код использует функции валидации PropType, он будет удален в продакшене. Как только это случится, любой код, который вызывает эти функции вручную (если он не был удалён в продакшене), будет выдавать ошибку. -### Declaring PropTypes is still fine {#declaring-proptypes-is-still-fine} +### Объявления PropTypes всё ещё работают {#declaring-proptypes-is-still-fine} -The normal usage of PropTypes is still supported: +Обычное использование PropTypes по-прежнему поддерживается: ```javascript Button.propTypes = { @@ -22,11 +22,11 @@ Button.propTypes = { }; ``` -Nothing changes here. +В этом плане ничего не изменилось. -### Don’t call PropTypes directly {#dont-call-proptypes-directly} +### Не вызвайте PropTypes напрямую {#dont-call-proptypes-directly} -Using PropTypes in any other way than annotating React components with them is no longer supported: +Использование PropTypes любым другим путём, кроме как на React-компонентах, больше не поддерживается: ```javascript var apiShape = PropTypes.shape({ @@ -34,34 +34,34 @@ var apiShape = PropTypes.shape({ statusCode: PropTypes.number.isRequired }).isRequired; -// Not supported! +// Не поддерживается! var error = apiShape(json, 'response'); ``` -If you depend on using PropTypes like this, we encourage you to use or create a fork of PropTypes (such as [these](https://github.com/aackerman/PropTypes) [two](https://github.com/developit/proptypes) packages). +Если вы полагаетесь на использования PropTypes, как в показанном выше примере, мы рекомендуем использовать или создать форк PropTypes (по аналогии [этим](https://github.com/aackerman/PropTypes) [двум](https://github.com/developit/proptypes) пакетам). -If you don't fix the warning, this code will crash in production with React 16. +Если вы не исправите это предупреждение, подобный код нарушит работу приложения при использовании React 16. -### If you don't call PropTypes directly but still get the warning {#if-you-dont-call-proptypes-directly-but-still-get-the-warning} +### Если вы не вызываете PropTypes напрямую, но по-прежнему получаете предупреждение {#if-you-dont-call-proptypes-directly-but-still-get-the-warning} -Inspect the stack trace produced by the warning. You will find the component definition responsible for the PropTypes direct call. Most likely, the issue is due to third-party PropTypes that wrap React’s PropTypes, for example: +Посмотрите на стек вызовов, созданный предупреждением. Вы найдете определение компонента, ответственного за непосредственный вызов PropTypes. Скорее всего, проблема из-за сторонних пакетах, которые используют PropTypes из React, например таким образом: ```js Button.propTypes = { highlighted: ThirdPartyPropTypes.deprecated( PropTypes.bool, - 'Use `active` prop instead' + 'Вместо текущего пропа используйте `active`' ) } ``` -In this case, `ThirdPartyPropTypes.deprecated` is a wrapper calling `PropTypes.bool`. This pattern by itself is fine, but triggers a false positive because React thinks you are calling PropTypes directly. The next section explains how to fix this problem for a library implementing something like `ThirdPartyPropTypes`. If it's not a library you wrote, you can file an issue against it. +В данном случае `ThirdPartyPropTypes.deprecated` -- это обёртка, вызывающая `PropTypes.bool`. В таком паттерне нет ничего плохого, но он приводит к ошибочному появлению предупреждения, поскольку React считает, что PropTypes вызываются напрямую. В следующем разделе объясняется, как решить такую проблему с библиотекой вроде `ThirdPartyPropTypes`. Если это не ваша библиотека, вы можете создать ишью, чтобы её автор решил проблему с предупреждением. -### Fixing the false positive in third party PropTypes {#fixing-the-false-positive-in-third-party-proptypes} +### Исправление ошибочного срабатывания в сторонних PropTypes {#fixing-the-false-positive-in-third-party-proptypes} -If you are an author of a third party PropTypes library and you let consumers wrap existing React PropTypes, they might start seeing this warning coming from your library. This happens because React doesn't see a "secret" last argument that [it passes](https://github.com/facebook/react/pull/7132) to detect manual PropTypes calls. +Если вы автор сторонней библиотеки PropTypes и предоставляете пользователям обёртку над встроенными в React PropTypes, они могут увидеть это предупреждение. Это происходит потому, что React не видит последний «секретный» аргумент, который [передаётся](https://github.com/facebook/react/pull/7132), чтобы определять вызовы PropTypes вручную. -Here is how to fix it. We will use `deprecated` from [react-bootstrap/react-prop-types](https://github.com/react-bootstrap/react-prop-types/blob/0d1cd3a49a93e513325e3258b28a82ce7d38e690/src/deprecated.js) as an example. The current implementation only passes down the `props`, `propName`, and `componentName` arguments: +А теперь перейдём к тому, как исправить предупреждение. В качестве примера будем использовать `deprecated` из библиотеки [react-bootstrap/react-prop-types](https://github.com/react-bootstrap/react-prop-types/blob/0d1cd3a49a93e513325e3258b28a82ce7d38e690/src/deprecated.js). Текущая реализация передаёт только аргументы `props`, `propName` и `componentName`: ```javascript export default function deprecated(propType, explanation) { @@ -79,11 +79,11 @@ export default function deprecated(propType, explanation) { } ``` -In order to fix the false positive, make sure you pass **all** arguments down to the wrapped PropType. This is easy to do with the ES6 `...rest` notation: +Для исправления ошибочного появления предупреждения, убедитесь, что вы передаёте **все** аргументы в обёрнутый PropType. Это легко сделать с помощью ES6-синтаксиса `...rest`: ```javascript export default function deprecated(propType, explanation) { - return function validate(props, propName, componentName, ...rest) { // Note ...rest here + return function validate(props, propName, componentName, ...rest) { // Обратите на ...rest вот тут if (props[propName] != null) { const message = `"${propName}" property of "${componentName}" has been deprecated.\n${explanation}`; if (!warned[message]) { @@ -92,9 +92,9 @@ export default function deprecated(propType, explanation) { } } - return propType(props, propName, componentName, ...rest); // and here + return propType(props, propName, componentName, ...rest); // и вот здесь }; } ``` -This will silence the warning. +После этого предупреждение больше не будет появляться. From f23af2c13baa4a5e36200fa74c42a66666a27be2 Mon Sep 17 00:00:00 2001 From: Nick Tishkevich Date: Fri, 15 Feb 2019 07:46:55 +0300 Subject: [PATCH 02/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 218b04777..1c2f80d62 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -10,7 +10,7 @@ permalink: warnings/dont-call-proptypes.html > > Вы можете использовать [codemod-скрипт](/blog/2017/04/07/react-v15.5.0.html#migrating-from-reactproptypes), чтобы провести замену в коде на использование этой библиотеки. -В следующем мажорном релизе React, если код использует функции валидации PropType, он будет удален в продакшене. Как только это случится, любой код, который вызывает эти функции вручную (если он не был удалён в продакшене), будет выдавать ошибку. +В следующем мажорном релизе React, если код использует функции валидации PropType, он будет удалён в продакшене. Как только это случится, любой код, который вызывает эти функции вручную (если он не был удалён в продакшене), будет выдавать ошибку. ### Объявления PropTypes всё ещё работают {#declaring-proptypes-is-still-fine} From 6c02d5dbba649d9762e958f78db384919a330981 Mon Sep 17 00:00:00 2001 From: Nick Tishkevich Date: Fri, 15 Feb 2019 07:47:01 +0300 Subject: [PATCH 03/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 1c2f80d62..818b181d9 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -44,7 +44,7 @@ var error = apiShape(json, 'response'); ### Если вы не вызываете PropTypes напрямую, но по-прежнему получаете предупреждение {#if-you-dont-call-proptypes-directly-but-still-get-the-warning} -Посмотрите на стек вызовов, созданный предупреждением. Вы найдете определение компонента, ответственного за непосредственный вызов PropTypes. Скорее всего, проблема из-за сторонних пакетах, которые используют PropTypes из React, например таким образом: +Посмотрите на стек вызовов, созданный предупреждением. Вы найдёте определение компонента, ответственного за непосредственный вызов PropTypes. Скорее всего, проблема из-за сторонних пакетов, которые используют PropTypes из React, например таким образом: ```js Button.propTypes = { From 37da138fadf9186cd6409b03709cec1bddd5f98a Mon Sep 17 00:00:00 2001 From: Anton Ahatov Date: Fri, 15 Feb 2019 12:20:23 +0300 Subject: [PATCH 04/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 818b181d9..3a53e9273 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -26,7 +26,7 @@ Button.propTypes = { ### Не вызвайте PropTypes напрямую {#dont-call-proptypes-directly} -Использование PropTypes любым другим путём, кроме как на React-компонентах, больше не поддерживается: +Использование PropTypes вне React-компонентов больше не поддерживается: ```javascript var apiShape = PropTypes.shape({ From 13ed91af22ffc075b706b17d1f4769a5b32d4fdd Mon Sep 17 00:00:00 2001 From: Anton Ahatov Date: Fri, 15 Feb 2019 12:20:38 +0300 Subject: [PATCH 05/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 3a53e9273..3f674a5a0 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -38,7 +38,7 @@ var apiShape = PropTypes.shape({ var error = apiShape(json, 'response'); ``` -Если вы полагаетесь на использования PropTypes, как в показанном выше примере, мы рекомендуем использовать или создать форк PropTypes (по аналогии [этим](https://github.com/aackerman/PropTypes) [двум](https://github.com/developit/proptypes) пакетам). +Если вы полагаетесь на использование PropTypes, как в показанном выше примере, мы рекомендуем использовать или создать форк PropTypes (по аналогии [этим](https://github.com/aackerman/PropTypes) [двум](https://github.com/developit/proptypes) пакетам). Если вы не исправите это предупреждение, подобный код нарушит работу приложения при использовании React 16. From 5a5379882a359bb66efef9a175096229b7db79b6 Mon Sep 17 00:00:00 2001 From: Anton Ahatov Date: Fri, 15 Feb 2019 12:21:02 +0300 Subject: [PATCH 06/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 3f674a5a0..b19bdbc97 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -55,7 +55,7 @@ Button.propTypes = { } ``` -В данном случае `ThirdPartyPropTypes.deprecated` -- это обёртка, вызывающая `PropTypes.bool`. В таком паттерне нет ничего плохого, но он приводит к ошибочному появлению предупреждения, поскольку React считает, что PropTypes вызываются напрямую. В следующем разделе объясняется, как решить такую проблему с библиотекой вроде `ThirdPartyPropTypes`. Если это не ваша библиотека, вы можете создать ишью, чтобы её автор решил проблему с предупреждением. +В данном случае `ThirdPartyPropTypes.deprecated` -- это обёртка, вызывающая `PropTypes.bool`. В таком паттерне нет ничего плохого, но он приводит к ошибочному появлению предупреждения, поскольку React считает, что PropTypes вызываются напрямую. В следующем разделе показано, как решить такую проблему с библиотекой вроде `ThirdPartyPropTypes`. Если это не ваша библиотека, вы можете создать ишью, чтобы её автор решил проблему с предупреждением. ### Исправление ошибочного срабатывания в сторонних PropTypes {#fixing-the-false-positive-in-third-party-proptypes} From ff2141935ade76be8f9081da5b6fab27d20ce1bb Mon Sep 17 00:00:00 2001 From: Anton Ahatov Date: Fri, 15 Feb 2019 12:25:26 +0300 Subject: [PATCH 07/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index b19bdbc97..9fd84ec38 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -6,7 +6,7 @@ permalink: warnings/dont-call-proptypes.html > Примечание: > -> С версии React 15.5 `React.PropTypes` были вынесены в отдельный пакет. Так что используйте [библиотеку `prop-types`](https://www.npmjs.com/package/prop-types). +> С версии React 15.5 `React.PropTypes` были вынесены в отдельный пакет. Вместо этого используйте [библиотеку `prop-types`](https://www.npmjs.com/package/prop-types). > > Вы можете использовать [codemod-скрипт](/blog/2017/04/07/react-v15.5.0.html#migrating-from-reactproptypes), чтобы провести замену в коде на использование этой библиотеки. From 6f4f60258cee09bb26b0482aabee11922c3c1567 Mon Sep 17 00:00:00 2001 From: Anton Ahatov Date: Fri, 15 Feb 2019 17:46:53 +0300 Subject: [PATCH 08/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 9fd84ec38..32b5d6cf5 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -6,7 +6,7 @@ permalink: warnings/dont-call-proptypes.html > Примечание: > -> С версии React 15.5 `React.PropTypes` были вынесены в отдельный пакет. Вместо этого используйте [библиотеку `prop-types`](https://www.npmjs.com/package/prop-types). +> С версии React 15.5 `React.PropTypes` были вынесены в отдельный пакет. Вместо них используйте [библиотеку `prop-types`](https://www.npmjs.com/package/prop-types). > > Вы можете использовать [codemod-скрипт](/blog/2017/04/07/react-v15.5.0.html#migrating-from-reactproptypes), чтобы провести замену в коде на использование этой библиотеки. From a2beadc77d91378f1d47d1aa419dd56f724cfd03 Mon Sep 17 00:00:00 2001 From: Anton Ahatov Date: Sat, 16 Feb 2019 04:30:19 +0300 Subject: [PATCH 09/11] Update content/warnings/dont-call-proptypes.md Co-Authored-By: lex111 --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 32b5d6cf5..f121983a4 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -59,7 +59,7 @@ Button.propTypes = { ### Исправление ошибочного срабатывания в сторонних PropTypes {#fixing-the-false-positive-in-third-party-proptypes} -Если вы автор сторонней библиотеки PropTypes и предоставляете пользователям обёртку над встроенными в React PropTypes, они могут увидеть это предупреждение. Это происходит потому, что React не видит последний «секретный» аргумент, который [передаётся](https://github.com/facebook/react/pull/7132), чтобы определять вызовы PropTypes вручную. +Если вы автор сторонней библиотеки PropTypes и предоставляете пользователям обёртку над встроенными в React PropTypes, они могут увидеть это предупреждение. Это происходит из-за того, что React не видит последний «секретный» аргумент, который [передаётся](https://github.com/facebook/react/pull/7132), чтобы определять вызовы PropTypes вручную. А теперь перейдём к тому, как исправить предупреждение. В качестве примера будем использовать `deprecated` из библиотеки [react-bootstrap/react-prop-types](https://github.com/react-bootstrap/react-prop-types/blob/0d1cd3a49a93e513325e3258b28a82ce7d38e690/src/deprecated.js). Текущая реализация передаёт только аргументы `props`, `propName` и `componentName`: From 37fcbba9f2970532e824908e49167e26c511f1a1 Mon Sep 17 00:00:00 2001 From: ANOTHER GUY Date: Thu, 21 Feb 2019 10:04:35 -0800 Subject: [PATCH 10/11] Update content/warnings/dont-call-proptypes.md --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index f121983a4..56204f24e 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -8,7 +8,7 @@ permalink: warnings/dont-call-proptypes.html > > С версии React 15.5 `React.PropTypes` были вынесены в отдельный пакет. Вместо них используйте [библиотеку `prop-types`](https://www.npmjs.com/package/prop-types). > -> Вы можете использовать [codemod-скрипт](/blog/2017/04/07/react-v15.5.0.html#migrating-from-reactproptypes), чтобы провести замену в коде на использование этой библиотеки. +> Вы можете использовать [codemod-скрипт](/blog/2017/04/07/react-v15.5.0.html#migrating-from-reactproptypes), автоматизировать переход на использование этой библиотеки. В следующем мажорном релизе React, если код использует функции валидации PropType, он будет удалён в продакшене. Как только это случится, любой код, который вызывает эти функции вручную (если он не был удалён в продакшене), будет выдавать ошибку. From 9946683c1a46c43b3bb866c7546c725f067e5925 Mon Sep 17 00:00:00 2001 From: ANOTHER GUY Date: Thu, 21 Feb 2019 10:04:41 -0800 Subject: [PATCH 11/11] Update content/warnings/dont-call-proptypes.md --- content/warnings/dont-call-proptypes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/warnings/dont-call-proptypes.md b/content/warnings/dont-call-proptypes.md index 56204f24e..afd81144c 100644 --- a/content/warnings/dont-call-proptypes.md +++ b/content/warnings/dont-call-proptypes.md @@ -61,7 +61,7 @@ Button.propTypes = { Если вы автор сторонней библиотеки PropTypes и предоставляете пользователям обёртку над встроенными в React PropTypes, они могут увидеть это предупреждение. Это происходит из-за того, что React не видит последний «секретный» аргумент, который [передаётся](https://github.com/facebook/react/pull/7132), чтобы определять вызовы PropTypes вручную. -А теперь перейдём к тому, как исправить предупреждение. В качестве примера будем использовать `deprecated` из библиотеки [react-bootstrap/react-prop-types](https://github.com/react-bootstrap/react-prop-types/blob/0d1cd3a49a93e513325e3258b28a82ce7d38e690/src/deprecated.js). Текущая реализация передаёт только аргументы `props`, `propName` и `componentName`: +Вот как исправляется это предупреждение. В качестве примера будем использовать `deprecated` из библиотеки [react-bootstrap/react-prop-types](https://github.com/react-bootstrap/react-prop-types/blob/0d1cd3a49a93e513325e3258b28a82ce7d38e690/src/deprecated.js). Текущая реализация передаёт только аргументы `props`, `propName` и `componentName`: ```javascript export default function deprecated(propType, explanation) {