Skip to content

Commit 6a9f360

Browse files
authored
Translation of Reference test renderer (reactjs#116)
* Update reference-test-renderer.md * Update reference-test-renderer.md * Update reference-test-renderer.md * Update reference-test-renderer.md * Update reference-test-renderer.md * Update reference-test-renderer.md * Update content/docs/reference-test-renderer.md * Update content/docs/reference-test-renderer.md * Update content/docs/reference-test-renderer.md * Update content/docs/reference-test-renderer.md * Update reference-test-renderer.md * Update reference-test-renderer.md * instantâneo -> snapshot * instantâneo -> snapshot * Update content/docs/reference-test-renderer.md Co-Authored-By: fjoshuajr <[email protected]> * Update content/docs/reference-test-renderer.md Co-Authored-By: fjoshuajr <[email protected]> * Update content/docs/reference-test-renderer.md Co-Authored-By: fjoshuajr <[email protected]>
1 parent 62fd1ea commit 6a9f360

File tree

1 file changed

+35
-35
lines changed

1 file changed

+35
-35
lines changed

content/docs/reference-test-renderer.md

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
---
22
id: test-renderer
3-
title: Test Renderer
3+
title: Renderizador de Teste
44
permalink: docs/test-renderer.html
55
layout: docs
66
category: Reference
77
---
88

9-
**Importing**
9+
**Importando**
1010

1111
```javascript
1212
import TestRenderer from 'react-test-renderer'; // ES6
13-
const TestRenderer = require('react-test-renderer'); // ES5 with npm
13+
const TestRenderer = require('react-test-renderer'); // ES5 com npm
1414
```
1515

16-
## Overview {#overview}
16+
## Visão Geral {#overview}
1717

18-
This package provides a React renderer that can be used to render React components to pure JavaScript objects, without depending on the DOM or a native mobile environment.
18+
Este pacote fornece um renderizador React que pode ser usado para renderizar componentes React para objetos JavaScript puros, sem depender do DOM ou de um ambiente móvel nativo.
1919

20-
Essentially, this package makes it easy to grab a snapshot of the platform view hierarchy (similar to a DOM tree) rendered by a React DOM or React Native component without using a browser or [jsdom](https://github.com/tmpvar/jsdom).
20+
Essencialmente, esse pacote facilita a captura de um snapshot da hierarquia de visualização da plataforma (semelhante a uma árvore DOM) processada por um componente React DOM ou React Native sem usar um navegador ou [jsdom](https://github.com/tmpvar/jsdom).
2121

22-
Example:
22+
Exemplo:
2323

2424
```javascript
2525
import TestRenderer from 'react-test-renderer';
@@ -38,9 +38,9 @@ console.log(testRenderer.toJSON());
3838
// children: [ 'Facebook' ] }
3939
```
4040

41-
You can use Jest's snapshot testing feature to automatically save a copy of the JSON tree to a file and check in your tests that it hasn't changed: [Learn more about it](https://facebook.github.io/jest/blog/2016/07/27/jest-14.html).
41+
Você pode usar o recurso de teste de snapshot do Jest para salvar automaticamente uma cópia da árvore JSON em um arquivo e verificar em seus testes que ela não foi alterada: [Aprenda mais sobre isso](https://facebook.github.io/jest/blog/2016/07/27/jest-14.html).
4242

43-
You can also traverse the output to find specific nodes and make assertions about them.
43+
Você também pode percorrer o resultado para encontrar nós específicos e fazer verificações sobre eles.
4444

4545
```javascript
4646
import TestRenderer from 'react-test-renderer';
@@ -49,7 +49,7 @@ function MyComponent() {
4949
return (
5050
<div>
5151
<SubComponent foo="bar" />
52-
<p className="my">Hello</p>
52+
<p className="my">Olá</p>
5353
</div>
5454
)
5555
}
@@ -71,7 +71,7 @@ expect(testInstance.findByProps({className: "sub"}).children).toEqual(['Sub']);
7171

7272
* [`TestRenderer.create()`](#testrenderercreate)
7373

74-
### TestRenderer instance {#testrenderer-instance}
74+
### Instância de TestRenderer {#testrenderer-instance}
7575

7676
* [`testRenderer.toJSON()`](#testrenderertojson)
7777
* [`testRenderer.toTree()`](#testrenderertotree)
@@ -94,157 +94,157 @@ expect(testInstance.findByProps({className: "sub"}).children).toEqual(['Sub']);
9494
* [`testInstance.parent`](#testinstanceparent)
9595
* [`testInstance.children`](#testinstancechildren)
9696

97-
## Reference {#reference}
97+
## Referência {#reference}
9898

9999
### `TestRenderer.create()` {#testrenderercreate}
100100

101101
```javascript
102102
TestRenderer.create(element, options);
103103
```
104104

105-
Create a `TestRenderer` instance with the passed React element. It doesn't use the real DOM, but it still fully renders the component tree into memory so you can make assertions about it. The returned instance has the following methods and properties.
105+
Cria uma instância do `TestRenderer` com o elemento React fornecido. Este método não usa o DOM real, mas ainda renderiza completamente a árvore de componentes na memória para que você possa fazer verificações sobre ela. A instância retornada possui os seguintes métodos e propriedades.
106106

107107
### `testRenderer.toJSON()` {#testrenderertojson}
108108

109109
```javascript
110110
testRenderer.toJSON()
111111
```
112112

113-
Return an object representing the rendered tree. This tree only contains the platform-specific nodes like `<div>` or `<View>` and their props, but doesn't contain any user-written components. This is handy for [snapshot testing](https://facebook.github.io/jest/docs/en/snapshot-testing.html#snapshot-testing-with-jest).
113+
Retorna um objeto representando a árvore renderizada. Essa árvore contém apenas os nós específicos da plataforma como `<div>` ou `<View>` e suas props, mas não contém nenhum componente criado pelo usuário. Isso é útil para [testes de snapshot](https://facebook.github.io/jest/docs/en/snapshot-testing.html#snapshot-testing-with-jest).
114114

115115
### `testRenderer.toTree()` {#testrenderertotree}
116116

117117
```javascript
118118
testRenderer.toTree()
119119
```
120120

121-
Return an object representing the rendered tree. Unlike `toJSON()`, the representation is more detailed than the one provided by `toJSON()`, and includes the user-written components. You probably don't need this method unless you're writing your own assertion library on top of the test renderer.
121+
Retorna um objeto representando a árvore renderizada. Ao contrário de `toJSON()`, a representação é mais detalhada que a fornecida por `toJSON()`, e inclui os componentes criados pelo usuário. Você provavelmente não precisa desse método, a menos que esteja escrevendo sua própria biblioteca de asserções sobre o renderizador de teste.
122122

123123
### `testRenderer.update()` {#testrendererupdate}
124124

125125
```javascript
126126
testRenderer.update(element)
127127
```
128128

129-
Re-render the in-memory tree with a new root element. This simulates a React update at the root. If the new element has the same type and key as the previous element, the tree will be updated; otherwise, it will re-mount a new tree.
129+
Re-renderiza a árvore na memória com um novo elemento raiz. Isso simula uma atualização do React na raiz. Se o novo elemento tiver o mesmo tipo e chave do elemento anterior, a árvore será atualizada; caso contrário, ele irá montar novamente uma nova árvore.
130130

131131
### `testRenderer.unmount()` {#testrendererunmount}
132132

133133
```javascript
134134
testRenderer.unmount()
135135
```
136136

137-
Unmount the in-memory tree, triggering the appropriate lifecycle events.
137+
Desmonta a árvore na memória, acionando os eventos de ciclo de vida apropriados.
138138

139139
### `testRenderer.getInstance()` {#testrenderergetinstance}
140140

141141
```javascript
142142
testRenderer.getInstance()
143143
```
144144

145-
Return the instance corresponding to the root element, if available. This will not work if the root element is a function component because they don't have instances.
145+
Retorna a instância correspondente ao elemento raiz, se disponível. Isso não funcionará se o elemento raiz for um componente de função, porque eles não possuem instâncias.
146146

147147
### `testRenderer.root` {#testrendererroot}
148148

149149
```javascript
150150
testRenderer.root
151151
```
152152

153-
Returns the root "test instance" object that is useful for making assertions about specific nodes in the tree. You can use it to find other "test instances" deeper below.
153+
Retorna o objeto raiz "instância de teste" que é útil para fazer asserções sobre nós específicos na árvore. Você pode usá-lo para encontrar outras "instâncias de teste" mais abaixo.
154154

155155
### `testInstance.find()` {#testinstancefind}
156156

157157
```javascript
158158
testInstance.find(test)
159159
```
160160

161-
Find a single descendant test instance for which `test(testInstance)` returns `true`. If `test(testInstance)` does not return `true` for exactly one test instance, it will throw an error.
161+
Encontra uma única instância de teste descendente para a qual `test(testInstance)` retorne `true`. Se `test(testInstance)` não retornar `true` para exatamente uma instância de teste, isso causará um erro.
162162

163163
### `testInstance.findByType()` {#testinstancefindbytype}
164164

165165
```javascript
166166
testInstance.findByType(type)
167167
```
168168

169-
Find a single descendant test instance with the provided `type`. If there is not exactly one test instance with the provided `type`, it will throw an error.
169+
Encontra uma única instância de teste descendente com o `type` fornecido. Se não houver exatamente uma instância de teste com o `type` fornecido, isso causará um erro.
170170

171171
### `testInstance.findByProps()` {#testinstancefindbyprops}
172172

173173
```javascript
174174
testInstance.findByProps(props)
175175
```
176176

177-
Find a single descendant test instance with the provided `props`. If there is not exactly one test instance with the provided `props`, it will throw an error.
177+
Encontra uma única instância de teste descendente com os `props` fornecidos. Se não houver exatamente uma instância de teste com os `props` fornecidos, isso causará um erro.
178178

179179
### `testInstance.findAll()` {#testinstancefindall}
180180

181181
```javascript
182182
testInstance.findAll(test)
183183
```
184184

185-
Find all descendant test instances for which `test(testInstance)` returns `true`.
185+
Encontra todas as instâncias de teste descendentes para as quais `test(testInstance)` retorne `true`.
186186

187187
### `testInstance.findAllByType()` {#testinstancefindallbytype}
188188

189189
```javascript
190190
testInstance.findAllByType(type)
191191
```
192192

193-
Find all descendant test instances with the provided `type`.
193+
Encontra todas as instâncias de teste descendentes com o `type` fornecido.
194194

195195
### `testInstance.findAllByProps()` {#testinstancefindallbyprops}
196196

197197
```javascript
198198
testInstance.findAllByProps(props)
199199
```
200200

201-
Find all descendant test instances with the provided `props`.
201+
Encontra todas as instâncias de teste descendentes com os `props` fornecidos.
202202

203203
### `testInstance.instance` {#testinstanceinstance}
204204

205205
```javascript
206206
testInstance.instance
207207
```
208208

209-
The component instance corresponding to this test instance. It is only available for class components, as function components don't have instances. It matches the `this` value inside the given component.
209+
A instância do componente correspondente a essa instância de teste. Está disponível apenas para componentes de classe, pois os componentes de função não possuem instâncias. Ele corresponde ao valor `this` dentro do componente fornecido.
210210

211211
### `testInstance.type` {#testinstancetype}
212212

213213
```javascript
214214
testInstance.type
215215
```
216216

217-
The component type corresponding to this test instance. For example, a `<Button />` component has a type of `Button`.
217+
O tipo de componente correspondente a essa instância de teste. Por exemplo, um componente `<Button />` tem o tipo `Button`.
218218

219219
### `testInstance.props` {#testinstanceprops}
220220

221221
```javascript
222222
testInstance.props
223223
```
224224

225-
The props corresponding to this test instance. For example, a `<Button size="small" />` component has `{size: 'small'}` as props.
225+
Os props correspondentes a essa instância de teste. Por exemplo, um componente `<Button size="small"/>` possui `{size: 'small'}` como props.
226226

227227
### `testInstance.parent` {#testinstanceparent}
228228

229229
```javascript
230230
testInstance.parent
231231
```
232232

233-
The parent test instance of this test instance.
233+
A instância de teste pai desta instância de teste.
234234

235235
### `testInstance.children` {#testinstancechildren}
236236

237237
```javascript
238238
testInstance.children
239239
```
240240

241-
The children test instances of this test instance.
241+
As instâncias de testes descendentes desta instância de teste.
242242

243-
## Ideas {#ideas}
243+
## Ideias {#ideas}
244244

245-
You can pass `createNodeMock` function to `TestRenderer.create` as the option, which allows for custom mock refs.
246-
`createNodeMock` accepts the current element and should return a mock ref object.
247-
This is useful when you test a component that relies on refs.
245+
Você pode passar a função `createNodeMock` para `TestRenderer.create` como opção, que permite mocks personalizados de refs.
246+
`createNodeMock` aceita o elemento atual e deve retornar um objeto mock de ref.
247+
Isso é útil quando você testa um componente que depende de refs.
248248

249249
```javascript
250250
import TestRenderer from 'react-test-renderer';
@@ -268,7 +268,7 @@ TestRenderer.create(
268268
{
269269
createNodeMock: (element) => {
270270
if (element.type === 'input') {
271-
// mock a focus function
271+
// mock de uma função de focus
272272
return {
273273
focus: () => {
274274
focused = true;

0 commit comments

Comments
 (0)