From 11bc1db285d050432376e10ae988ba7b10b13957 Mon Sep 17 00:00:00 2001 From: Chen <1207145565@qq.com> Date: Fri, 29 Oct 2021 09:53:10 +0800 Subject: [PATCH] docs(wrapper-arrat): add is warning --- docs/fr/api/wrapper-array/is.md | 17 +++++++++++++++++ docs/ja/api/wrapper-array/is.md | 14 ++++++++++++++ docs/zh/api/wrapper-array/is.md | 14 ++++++++++++++ 3 files changed, 45 insertions(+) diff --git a/docs/fr/api/wrapper-array/is.md b/docs/fr/api/wrapper-array/is.md index 465aecb37..1e29f32c3 100644 --- a/docs/fr/api/wrapper-array/is.md +++ b/docs/fr/api/wrapper-array/is.md @@ -1,5 +1,22 @@ ## is +::: warning Avertissement de déprédation +L'utilisation de `is` pour affirmer que le nœud DOM est déprécié et sera supprimé. + +Considérez un appariement personnalisé tel que ceux fournis dans [jest-dom](https://github.com/testing-library/jest-dom#custom-matchers). +ou pour l'assertion de type d'élément DOM, utilisez native [`Element.tagName`](https://developer.mozilla.org/en-US/docs/Web/API/Element/tagName) à la place. + +Pour conserver ces tests, un remplacement valable pour : + +- `is('DOM_SELECTOR')` est une affirmation de `wrapper.wrappers.every(wrapper => wrapper.element.tagName === 'DOM_SELECTOR')`. +- `is('ATTR_NAME')` est une affirmation véridique d `wrapper.wrappers.every(wrapper => wrapper.attributes('ATTR_NAME'))`. +- `is('CLASS_NAME')` est une affirmation véridique d `wrapper.wrappers.every(wrapper => wrapper.classes('CLASS_NAME'))`. + +L'affirmation contre la définition du composant n'est pas dépréciée + +En cas d'utilisation avec findComponent, accédez à l'élément DOM avec `findComponent(Comp).element` +::: + Affirmer que chaque `Wrapper` dans le noeud DOM `WrapperArray` ou `vm` correspond à [selector](../selectors.md). - **Arguments:** diff --git a/docs/ja/api/wrapper-array/is.md b/docs/ja/api/wrapper-array/is.md index faebaf85b..b1c5867c0 100644 --- a/docs/ja/api/wrapper-array/is.md +++ b/docs/ja/api/wrapper-array/is.md @@ -1,5 +1,19 @@ ## is(selector) +::: warning Deprecation warning +`is` を使用して、 DOM ノードまたは `vm` がセレクタに一致することをアサートするのは非推奨となり、削除される予定です。 + +[jest-dom](https://github.com/testing-library/jest-dom#custom-matchers) で提供されているようなカスタムマッチャの使用を検討してください。または、 DOM 要素などに対するアサーションには、代わりにネイティブの [Element.tagName](https://developer.mozilla.org/en-US/docs/Web/API/Element/tagName) を使用してください。 + +テストを維持するためには、以下の置き換えが有効です。 + +- `is('DOM_SELECTOR')` は `wrapper.wrappers.every(wrapper => wrapper.element.tagName === 'DOM_SELECTOR')` のアサーションです。 +- `is('ATTR_NAME')` は真に `wrapper.wrappers.every(wrapper => wrapper.attributes('ATTR_NAME'))` のアサーションです。 +- `is('CLASS_NAME')` は真に `wrapper.wrappers.every(wrapper => wrapper.classes('CLASS_NAME'))` のアサーションです。 + +findComponent で使用する場合は、 `findComponent(Comp).element` で DOM 要素にアクセスします。 +::: + `WrapperArray` の全ての `Wrapper` の DOM ノード、もしくは[セレクタ](../selectors.md)が `vm` とマッチするか検証します。 - **引数:** diff --git a/docs/zh/api/wrapper-array/is.md b/docs/zh/api/wrapper-array/is.md index a4818f79f..690cacc63 100644 --- a/docs/zh/api/wrapper-array/is.md +++ b/docs/zh/api/wrapper-array/is.md @@ -1,5 +1,19 @@ ## is +::: warning 废弃警告 +使用 `is` 断言 DOM 结点或 `vm` 匹配选择器的方式已经被废弃并会被移除。 + +可以考虑一个诸如 [jest-dom](https://github.com/testing-library/jest-dom#custom-matchers) 提供的自定义匹配。或为 DOM 元素类型断言换用原生的 [`Element.tagName`](https://developer.mozilla.org/en-US/docs/Web/API/Element/tagName)。 + +为了保留这些测试，一个有效替换： + +- `is('DOM_SELECTOR')` 的方式是一个 `wrapper.wrappers.every(wrapper => wrapper.element.tagName === 'DOM_SELECTOR')` 的断言。 +- `is('ATTR_NAME')` 的方式是一个 `wrapper.wrappers.every(wrapper => wrapper.attributes('ATTR_NAME'))` 的 truthy 断言。 +- `is('CLASS_NAME')` 的方式是一个 `wrapper.wrappers.every(wrapper => wrapper.classes('CLASS_NAME'))` 的 truthy 断言。 + +当使用 `findComponent` 时，通过 `findComponent(Comp).element` 访问 DOM 元素。 +::: + 断言 `WrapperArray` 的每个 `Wrapper` 的 DOM 节点或 `vm` 匹配[选择器](../selectors.md)。 - **参数：**