diff --git a/en/api/nuxt-render-and-get-window.md b/en/api/nuxt-render-and-get-window.md index 20a7e6089..0610360c6 100644 --- a/en/api/nuxt-render-and-get-window.md +++ b/en/api/nuxt-render-and-get-window.md @@ -1,28 +1,30 @@ --- title: "API: nuxt.renderAndGetWindow(url, options)" -description: Get the window from a given url of a nuxt.js application. +description: Obtient la `window` à une URL donnée d'une application Nuxt.js. --- -# nuxt.renderAndGetWindow(url, options = {}) (En) +# nuxt.renderAndGetWindow(url, options = {}) -- Type: `Function` -- Argument: `String` - 1. `String`: url to render - 2. *Optional*, `Object`: options - - virtualConsole: `Boolean` (default: `true`) -- Returns: `Promise` - - Returns: `window` +- Type : `Function` +- Argument : `String` + 1. `String` : l'URL à rendre + 2. *Optional*, `Object` : options + - virtualConsole : `Boolean` (par défaut : `true`) +- Valeur de retour : `Promise` + - Valeur de retour : `window` -> Get the window from a given url of a nuxt.js application. +> Obtient la `window` à une URL donnée d'une application Nuxt.js. -
This method is made for [test purposes](guide/development-tools#end-to-end-testing).
+Cette méthode est faite pour les [tests](guide/development-tools#tests-de-bout-en-bout).
+ +Pour utiliser cette fonction, vous devez installer `jsdom` : -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
To use this function, you have to install `jsdom`:
```bash npm install --save-dev jsdom ``` -Example: +Exemple : + ```js const { Nuxt, Builder } = require('nuxt') @@ -33,7 +35,7 @@ const nuxt = new Nuxt(config) nuxt.renderAndGetWindow('http://localhost:3000') .then((window) => { - // Display the head⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
This method should be used mostly for [test purposes](/guide/development-tools#end-to-end-testing) as well with [nuxt.renderAndGetWindow](/api/nuxt-render-and-get-window).
+Cette méthode devrait être utilisée en particulier pour les [tests](guide/development-tools#tests-de-bout-en-bout) aussi bien que [`nuxt.renderAndGetWindow`](/api/nuxt-render-and-get-window). -`nuxt.renderRoute` should be executed after the build process in production mode (dev: false).
+`nuxt.renderRoute` devrait être exécuté après le processus de build en mode production (`dev: false`).
+ +Exemple : -Example: ```js const { Nuxt, Builder } = require('nuxt') @@ -33,12 +34,12 @@ new Builder(nuxt) .build() .then(() => nuxt.renderRoute('/')) .then(({ html, error, redirected }) => { - // html will be always a string + // `html` sera toujours une chaine de caractères - // error not null when the error layout is displayed, the error format is: - // { statusCode: 500, message: 'My error message' } + // `error` sera non `null` quand le layout d'erreur est affiché, le format d'erreur est : + // { statusCode: 500, message: 'Mon message d'erreur' } - // redirected is not false when redirect() has been used in data() or fetch() + // `redirected` n'est pas `false` quand `redirect()` est utilisé dans `data()` ou `fetch()` // { path: '/other-path', query: {}, status: 302 } }) ``` diff --git a/en/api/nuxt-render.md b/en/api/nuxt-render.md index 2329cdb59..8433d0db3 100644 --- a/en/api/nuxt-render.md +++ b/en/api/nuxt-render.md @@ -1,19 +1,20 @@ --- -title: "API: nuxt.render(req, res)" -description: You can use Nuxt.js as a middleware for your node.js server. +title: "API : nuxt.render(req, res)" +description: Vous pouvez utiliser Nuxt.js comme un middleware pour votre serveur Node.js. --- -# nuxt.render(req, res) (En) +# nuxt.render(req, res) -- Type: `Function` -- Arguments: +- Type : `Function` +- Arguments : 1. [Request](https://nodejs.org/api/http.html#http_class_http_incomingmessage) 2. [Response](https://nodejs.org/api/http.html#http_class_http_serverresponse) -- Returns: `Promise` +- Valeur de retour : `Promise` -> You can use nuxt.js as a middleware with `nuxt.render` for your node.js server. +> Vous pouvez utiliser Nuxt.js comme un middleware avec `nuxt.render` pour votre serveur Node.js. + +Example with [Express](https://github.com/expressjs/express) : -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
Example with [Express.js](https://github.com/expressjs/express):
```js const { Nuxt, Builder } = require('nuxt') @@ -21,15 +22,15 @@ const app = require('express')() const isProd = (process.env.NODE_ENV === 'production') const port = process.env.PORT || 3000 -// We instantiate nuxt.js with the options +// Nous instancions Nuxt.js avec les options const config = require('./nuxt.config.js') config.dev = !isProd const nuxt = new Nuxt(config) -// Render every route with nuxt.js +// Rendre chaque route avec Nuxt.js app.use(nuxt.render) -// Build only in dev mode with hot-reloading +// Faire le build seulement en mode de développement avec du rechargement à chaud if (config.dev) { new Builder(nuxt).build() .then(listen) @@ -43,10 +44,10 @@ else { } function listen() { - // Listen the server + // Écouter le serveur app.listen(port, '0.0.0.0') - console.log('Server listening on localhost:' + port) + console.log('Le serveur écoute sur `localhost:' + port + '`.') } ``` -It's recommended to call **nuxt.render** at the end of your middlewares since it will handle the rendering of your web application and won't call next()
+Il est recommandé d'appeler `nuxt.render` à la fin de votre middlewares ainsi il fera le rendu de votre application web et n'appellera pas `next()`.
diff --git a/en/api/nuxt.md b/en/api/nuxt.md index cbc7ae056..681f80e46 100644 --- a/en/api/nuxt.md +++ b/en/api/nuxt.md @@ -1,44 +1,45 @@ --- -title: "API: Nuxt(options)" -description: You can use nuxt.js programmatically to use it as a middleware giving you the freedom of creating your own server for rendering your web applications. +title: "API : Nuxt(options)" +description: Vous pouvez utiliser Nuxt.js par programmation et l'utiliser en tant que middleware vous donnant la possibilité de créer votre propre serveur pour le rendu de vos applications web. --- -# Using Nuxt.js Programmatically (En) +# Utiliser Nuxt.js par programmation -⚠Cette page est actuellement en cours de traduction française. Vous pouvez repasser plus tard ou participer à la traduction de celle-ci dès maintenant !
You might want to use your own server with your middleware and your API. That's why you can use Nuxt.js programmatically.
+Vous voudrez peut-être utiliser votre propre serveur avec vos middlewares et votre API. C'est pourquoi vous pouvez utiliser Nuxt.js par programmation. + +Vous pouvez inclure Nuxt.js ainsi : -You can require Nuxt.js like this: ```js const { Nuxt, Builder } = require('nuxt') ``` -## Nuxt Constructor +## Constructeur Nuxt -To see the list of options to give to Nuxt.js, see the configuration section. +Pour voir la liste des options à fournir à Nuxt.js, consultez la section configuration. ```js -// Require Nuxt And Builder modules +// Inclure les modules `Nuxt` et `Builder` const { Nuxt, Builder } = require('nuxt') -// Require nuxt config +// Inclure la configuration Nuxt const config = require('./nuxt.config.js') -// Create a new nuxt instance +// Créer une nouvelle instance de Nuxt const nuxt = new Nuxt(config) -// Enable live build & reloading on dev +// Activer le build live et le rechargement à chaud reloading en développement if (nuxt.options.dev) { new Builder(nuxt).build() } -// We can use nuxt.render(req, res) or nuxt.renderRoute(route, context) +// Nous pouvons utiliser `nuxt.render(req, res)` ou `nuxt.renderRoute(route, context)` ``` -You can take a look at the [nuxt-express](https://github.com/nuxt/express) and [adonuxt](https://github.com/nuxt/adonuxt) starters to get started quickly. +Vous pouvez jeter un œil aux modules de démarrage [nuxt-express](https://github.com/nuxt/express) et [adonuxt](https://github.com/nuxt/adonuxt) pour démarrer rapidement -### Debug logs +### Logs de débogue -If you want to display nuxt.js logs, you can add to the top of your file: +Si vous voulez afficher les logs de Nuxt.js, vous pouvez ajouter en première ligne de fichier le code suivant : ```js process.env.DEBUG = 'nuxt:*'