v2.6.0

[pi0]

Beta Testing

If you are interested in early testing this release, you can temporarily switch to the nuxt-edge distribution. Please make this change in package.json:

{
  "dependencies": {
--    "nuxt": "^2.5.1",
++    "nuxt-edge": "^2.6.0-25904774.3c737017`",
  }
}

Migration Guide

This version is addressing most of the problems of 2.5 and is without any breaking changes. For most of the users, a normal version upgrade would be enough. However, reading this guide can help to have a smooth upgrade.

General Tips

• Using yarn as the package manager is more preferred as Nuxt is internally being tested against yarn
• Before upgrade ensure to remove yarn.lock, package-lock.json and node_modules
• After full install and testing, also consider upgrading other dependencies. The yarn outdated command can be used.

Missing App Dependencies

Because of how package managers (yarn, npm) work, a wrong version of a dependency from one of the other dependencies may be hoisted into node_modules. Nuxt is strict about this and provides instructions for dependency resolution so please follow it.

The well-known problem is with firebase package that requires to manually installing node-fetch dependency in your project.

Core-js

Since core-js@2 and core-js@3 are both supported from babel 7.4.0, Starting from 2.6 Nuxt supports both versions (#5411). It is highly advised to stick with 2 (default) unless having a special dependency that needs 3. (Instructions for core-js@2 are not required but recommended)

core-js@2

• yarn: yarn add -D core-js@2 @babel/runtime-corejs2
• npm: npm i -D core-js@2 @babel/runtime-corejs2

core-js@3

• yarn: yarn add -D core-js@3 @babel/runtime-corejs3
• npm: npm i -D core-js@3 @babel/runtime-corejs3

Edit nuxt.config.js:

export default {
  build: {
    babel: {
      presets({ isServer }) {
        return [
          [
            require.resolve('@nuxt/babel-preset-app'),
            // require.resolve('@nuxt/babel-preset-app-edge'), // For nuxt-edge users
            {
              targets: isServer ? { node: '10' } : { ie: '11' },
              corejs: { version: 3 }
            }
          ]
        ]
      }
    }
  }
}

Typescript

Nuxt 2.5 users may only require to add ts-node to the dependencies

Beta Testers : Replace nuxt by nuxt-edge, and @nuxt/typescript by @nuxt/typescript-edge in the following instructions.

1. Remove nuxt-ts dependency (2.4 users only)
   • yarn: yarn remove nuxt-ts
   • npm: npm remove nuxt-ts
2. Add nuxt and ts-node to dependencies:
   • yarn: yarn add nuxt ts-node
   • npm: npm i nuxt ts-node
3. Add @nuxt/typescript to devDependencies:
   • yarn: yarn add -D @nuxt/typescript
   • npm: npm i -D @nuxt/typescript
4. Create an empty tsconfig.json file. Nuxt will automatically generate it with defaults at first run, then you can edit it to fit your needs

Features

• feat(babel-preset-app): support specifying core-js version (feat(babel-preset-app): support specifying core-js version #5411) (Xin Du (Clark)) (159123f)
• feat(cli): add internal _generate and _build options (feat(cli): add internal _generate and _build flags #5434) (Pooya Parsa) (516aea3)
• feat(cli): add --quiet option to nuxt generate command (feat(cli): add --quiet option to nuxt generate command #5357) (Franck Abgrall) (91f4eb0)
• feat(typescript): detect typescript based on tsconfig.json (feat(typescript): detect typescript based on tsconfig.json #5412) (Pooya Parsa) (6ffc5c5)
• feat(vue-renderer): add csp meta tags (feat(vue-renderer): add csp meta tags #5354) (James George) (b978a37)

Fixes

• fix: unexpected token export in importing babel runtime helper (fix: SyntaxError Unexpected token export in importing babel runtime helper #5401) (ryota yamamoto) (3b85dd9)
• fix(core): call ready to prevent breaking changes (Pooya Parsa) (revert(core): call ready to prevent breaking changes #5413) (001ba77)
• fix(build): disable loading babel.config.js by default (fix(build): disable loading babel.config.js by default #5365) (Xin Du (Clark)) (64fa424)
• fix(builder): await for renderer to load resources (fix(builder): await for renderer to load resources #5341) (Pooya Parsa) (caf5198)
• fix(cli): catch all possible errors thrown from proper-filelock (fix(cli): catch all possible errors thrown from proper-filelock #5347) (Pim) (39bbe46)
• fix(renderer): retry render if renderer is in loading or created state (fix(renderer): retry render if renderer is in loading or created state #5417) (Pooya Parsa) (8b99695)
• fix(vue-app): decode uri in getlocation (fix(vue-app): decode uri in getlocation #5337) (Johan Roxendal) (77dcfe6)
• fix(vue-app): prevent mounting page twice on redirect (fix(vue-app): prevent mounting page twice on redirect #5361) (noe132) (2d73e8a)
• fix(vue-renderer): add the csp hash if unsafe-inline hasn't been specified (fix(vue-renderer): add the csp hash if unsafe-inline hasn't been specified #5387) (Sam Bowler) (97db6a4)
• fix(types): add type definition for typescript.typeCheck (fix(types): add type definition for typescript.typeCheck #5326) (Daniel Roe) (2c1444d)

Refactors

• refactor(typescript): only generate tsconfig.json if missing (fix(packages/typescript): Fix not to overwrite tsconfig #5356) (refactor(ts): only generate tsconfig.json if missing #5367) (Kevin Marrec) (9a3fc8a)
• refactor(vue-renderer): improve ready status error (refactor(vue-renderer): improve ready status error #5339) (Pooya Parsa) (535327c)
• refactor(webpack): add ability to get webpack config class (refactor(webpack): add ability to get webpack config class #5378) (Damian Stasik) (abf7db1)

Examples

• examples: add docker example (examples: add docker example #5430) (Utkarsh Gupta) (3eec115)
• examples(vue-apollo): update to @nuxtjs/apollo 4.x (examples(vue-apollo): update to @nuxtjs/apollo 4.x #5345) (Dmitry Molotkov) (95f2a12)
• examples(with-buefy): update example (examples(with-buefy): update example #5348) (Dmitry Molotkov) (ce66a8c)
• examples(with-element-ui): fix package scripts (examples(with-element-ui): fix package scripts #5349) (Dmitry Molotkov) (10812e3)

Chore

• chore(postcss): deprecate config support (chore(postcss): deprecate config support #5419) (Alexander Lichter) (1bd4fb1)
• chore(readme): fix grammar (chore(README): fix grammar #5395) (Irvin Lin) (f8d3626)

Dependency Upgrades

• loading-screen: use wss for https (fix: use wss for https loading-screen#4)
• loading-screen: fallback to fetch if ws fails (feat: fallback to fetch if ws timesout loading-screen#6)
• node-proper-lockfile: - fix mtime precision on some filesystems (#​88) (f266158), closes #​82 #​87

[codecov-io]

Codecov Report

Merging #5352 into 2.x will increase coverage by 0.42%.
The diff coverage is 94.73%.

@@            Coverage Diff            @@
##             2.x    #5352      +/-   ##
=========================================
+ Coverage   95.7%   96.12%   +0.42%     
=========================================
  Files         74       74              
  Lines       2513     2555      +42     
  Branches     639      650      +11     
=========================================
+ Hits        2405     2456      +51     
+ Misses        91       83       -8     
+ Partials      17       16       -1

Impacted Files	Coverage Δ
packages/config/src/config/build.js	100% <ø> (ø)	⬆️
packages/typescript/src/index.js	100% <100%> (ø)	⬆️
packages/vue-renderer/src/renderer.js	95.56% <100%> (+3.48%)	⬆️
packages/webpack/src/utils/postcss.js	93.22% <100%> (+0.62%)	⬆️
packages/cli/src/imports.js	100% <100%> (ø)	⬆️
packages/cli/src/commands/dev.js	84.61% <100%> (ø)	⬆️
packages/webpack/src/config/client.js	98.18% <100%> (+0.18%)	⬆️
packages/core/src/nuxt.js	94.73% <100%> (+0.29%)	⬆️
packages/builder/src/builder.js	100% <100%> (ø)	⬆️
packages/cli/src/commands/build.js	86.36% <100%> (ø)	⬆️
... and 10 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 5d7757b...516aea3. Read the comment docs.

[kevinmarrec]

core-js & node-fetch should not be present in examples/vue-apollo/package.json, they are shipped by packages/vue-app.

Didn't find how to suggest multiple line edits (I think that Github doesn't have this feature yet)

[sgmheyhey]

Have ever tried with firebase? Errors happened newly like The XMLHttpRequest compatibility library was not found.

[pi0]

@sgmheyhey Did you tried adding xmlhttprequest npm dependency?

[sgmheyhey]

No needed with Nuxt.js v2.5.2-25897721.3b85dd97.

And v2.6, I've tried to add xmlhttprequest. But not worked.

[pi0]

@sgmheyhey Please create an issue with a small repository or at least link to the method that you are deploying to the firebase. Sharing custom server.js, nuxt.config and package.json can also help.

[sgmheyhey]

Failed to open new issue. :( #5441