Published on

Vue 2.7 is Now in Beta

Authors

We are happy to announce that Vue 2.7 is now in beta.


Despite Vue 3 now being the default version, we understand that there are still many users who have to stay on Vue 2 due to dependency compatibility, browser support requirements, or simply not enough bandwidth to upgrade. In Vue 2.7, we have backported some of the most important features from Vue 3 so that Vue 2 users can benefit from them as well.

Backported Features

In addition, the following APIs are also supported:

  • defineComponent() with improved type inference (compared to Vue.extend)

  • h(), useSlot(), useAttrs(), useCssModules()

  • set(), del() and nextTick() are also provided as named exports in ESM builds.

  • The emits option is also supported, but only for type-checking purposes (does not affect runtime behavior)

    2.7 also supports using ESNext syntax in template expressions. When using a build system, the compiled template render function will go through the same loaders / plugins configured for normal JavaScript. This means if you have configured Babel for .js files, it will also apply to the expressions in your SFC templates.

Notes on API exposure

  • In ESM builds, these APIs are provided as named exports (and named exports only):

    js
    import Vue, { ref } from 'vue'
    
    Vue.ref // undefined, use named export instead
  • In UMD and CJS builds, these APIs are exposed as properties on the global Vue object.

  • When bundling with CJS builds externalized, bundlers should be able to handle ESM interop when externalizing CJS builds.

Behavior Differences from Vue 3

The Composition API is backported using Vue 2's getter/setter-based reactivity system to ensure browser compatibility. This means there are some important behavior differences from Vue 3's proxy-based system:

  • All Vue 2 change detection caveats still apply.

  • reactive(), ref(), and shallowReactive() will directly convert original objects instead of creating proxies. This means:

    js
    // true in 2.7, false in 3.x
    reactive(foo) === foo
  • readonly() does create a separate object, but it won't track newly added properties and does not work on arrays.

  • Avoid using arrays as root values in reactive() because without property access the array's mutation won't be tracked (this will result in a warning).

  • Reactivity APIs ignore properties with symbol keys.

In addition, the following features are explicitly NOT ported:

  • createApp() (Vue 2 doesn't have isolated app scope)
  • ❌ Top-level await in <script setup> (Vue 2 does not support async component initialization)
  • ❌ TypeScript syntax in template expressions (incompatible w/ Vue 2 parser)
  • ❌ Reactivity transform (still experimental)
  • expose option is not supported for options components (but defineExpose() is supported in <script setup>).

Beta Adoption Guide

2.7 is currently in beta stage and may still have rough edges. Please help us test its stability by opting into the beta. Here's how:

Vue CLI

  1. Upgrade local @vue/cli-xxx dependencies the latest version in your major version range:

    • ~4.5.18 for v4
    • ~5.0.6 for v5
  2. Upgrade vue to v2-beta, or pin to a specific version (latest beta as of this writing is 2.7.0-beta.3). You can also remove vue-template-compiler from the dependencies - it is no longer needed in 2.7.

  3. If you were previously using @vue/composition-api, update imports from it to vue instead.

  4. Opt-in to vue-loader v15 beta. Since vue-loader is a transitive dependency of @vue/cli-service, you will need to force your package manager to explicitly use the beta version. The forced resolution will no longer be necessary when it goes stable.

    • For npm (>=8.3.0), use the overrides field in package.json.

      If using Vue CLI v4:

      json
      {
        "overrides": {
          "vue-loader": "^15.10.0-beta.6"
        }
      }

      If using Vue CLI v5:

      json
      {
        "overrides": {
          "@vue/vue-loader-v15": "npm:vue-loader@^15.10.0-beta.6"
        }
      }
    • For yarn, use the resolutions field in package.json.

      If using Vue CLI v4:

      json
      {
        "resolutions": {
          "vue-loader": "^15.10.0-beta.6"
        }
      }

      If using Vue CLI v5:

      json
      {
        "resolutions": {
          "@vue/vue-loader-v15": "npm:vue-loader@^15.10.0-beta.6"
        }
      }
    • For pnpm, use pnpm.overrides:

      If using Vue CLI v4:

      json
      {
        "pnpm": {
          "overrides": {
            "vue-loader": "^15.10.0-beta.6"
          }
        }
      }

      If using Vue CLI v5:

      json
      {
        "pnpm": {
          "overrides": {
            "@vue/vue-loader-v15": "npm:vue-loader@^15.10.0-beta.6"
          }
        }
      }
  5. If you were previously using any libraries that rely on vue-demi (e.g. VueUse or Pinia), you may need to remove lockfile and do a fresh npm install to upgrade to the latest version of vue-demi.

  6. The SFC compiler for 2.7 now uses PostCSS 8 (upgraded from 7). PostCSS 8 should be backwards compatible with most plugins, but the upgrade may cause issues if you were previously using a custom PostCSS plugin that can only work with PostCSS 7. In such cases, you will need to upgrade the relevant plugins to their PostCSS 8 compatible versions.

Vite

2.7 support for Vite is provided via a new plugin: @vitejs/plugin-vue2. This new plugin requires Vue 2.7 or above and supersedes the existing vite-plugin-vue2.

Note that the new plugin does not handle Vue-specific JSX / TSX transform, which is intentional. Vue 2 JSX / TSX transform should be handled in a separate, dedicated plugin.

Volar Compatibility

2.7 ships improved type definitions so it is no longer necessary to install @vue/runtime-dom just for Volar template type inference support. All you need now is the following config in tsconfig.json:

json
{
  // ...
  "vueCompilerOptions": {
    "target": 2.7
  }
}

Implications of the 2.7 Release

2.7 stable is scheduled to land around end of June 2022. As stated before, it will be the final minor release of Vue 2.x. Once 2.7 is released as stable, Vue 2 will no longer receive new features, and will enter LTS (long-term support) which lasts for 18 months.

This means Vue 2 will reach End of Life by the end of 2023. We believe this should provide plenty of time for most of the ecosystem to migrate over to Vue 3. However, we also understand that there could be teams or projects that cannot upgrade by this timeline while still need to fullfil security and compliance requirements. We are planning to provide extended support for Vue 2 for teams with such needs - if your team expects to be using Vue 2 beyond end of 2023, make sure to plan head and register your interest here.