Ember 3.27 Launched

In the present day the Ember venture is asserting launch 3.27 of Ember.js, Ember Information, and Ember CLI. This can be a minor model, steady launch.

We’re additionally asserting the beginning of the three.28 beta cycle for all sub-projects. We encourage our neighborhood (particularly addon authors) to assist check beta builds and report any bugs earlier than they’re printed as a steady launch in six weeks’ time. The ember-try addon is an effective way to constantly check your initiatives towards the newest Ember releases.

Ember.js 3.28 (once more, beginning beta right this moment) is the ultimate deliberate model of the three.x launch cycle, and can
turn into an LTS launch. As of the three.28-beta being launched, the primary improvement
department of all Ember initiatives will turn into 4.0. Search for extra info on Ember
4.0 right here on the weblog this coming week.

You possibly can learn extra about our normal launch course of with these assets:

Ember.js

Ember.js is the core framework for constructing formidable net purposes.

Adjustments in Ember.js 3.27

Ember.js 3.27 is an incremental, backwards appropriate launch of Ember with bug fixes, efficiency enhancements, and deprecations.
For a full set of adjustments see CHANGELOG.md.

Notable Bug Fixes

• Prior to three.27 <:inverse> wouldn’t at all times alias else blocks. That is
  corrected in glimmerjs/glimmer-vm#1296.
• Ember.js 3.27.0 was launched in early Could and included a number of regressions.
  These have been largely associated to the adjustments within the glimmer VM and and the
  implementation of a number of deprecations, and have been corrected in patch
  releases main as much as 3.27.5.

Function Additions

Contextual Helpers & Modifiers

For a number of years Ember has supplied a mechanism known as “contextual elements”.
This API permits a developer to yield a part, optionally with arguments
to use, right into a block.

In RFC #432
further APIs have been proposed which permit helpers and modifiers for use in
the identical means.

For instance the structure for a SuperForm part could be applied as:

// app/elements/super-form.hbs
<type>
  {{yield (hash

    Enter=(part "super-input" type=this mannequin=this.mannequin)
    Textarea=(part "super-textarea" type=this mannequin=this.mannequin)
    Submit=(part "super-submit" type=this mannequin=this.mannequin)

    is-valid=(helper "super-is-valid" type=this mannequin=this.mannequin)
    error-for=(helper "super-error-for" type=this mannequin=this.mannequin)

    auto-resize=(modifier "super-auto-resize")

  )}}
</type>

// app/templates/index.hbs
<SuperForm @mannequin={{this.publish}} as |f|>

  {{! Invoke a contextual part }}
  <f.Enter @title="title" />

  {{! Invoke contextual helpers }}
  {{#except (f.is-valid "title")}}
    <div class="error">This area {{f.error-for "title"}}</div>
  {{/except}}

  {{! Invoke a contextual modifier on a contextual part invocation }}
  <f.Textarea @title="physique" {{f.auto-resize maxHeight="500"}} />

  <f.Submit />
</SuperForm>

Ember 3.27 introduces the ultimate set of deprecations concentrating on Ember 4.0. The
newly launched deprecations primarily influence uncommonly used APIs. As at all times,
deprecated APIs are documented with a transition path within the deprecation
guides.

A number of notable deprecations added in 3.27 are:

Invoking Helpers With out Arguments and Parentheses in Named Argument Positions

In some templates, a helper handed as an argument may be handled as an
invocation as an alternative of passing the uninvoked helper as a price. For instance:

{{! is someHelper invoked, or handed as a reference? }}
<SomeComponent @arg={{someHelper}} />

{{! (someHelper) is clearly an invocation with no arguments }}
<SomeComponent @arg={{(someHelper)}} />

The non-param model of helper passing will move a reference to the helper
in Ember 4.0. See the deprecation information
entry
for extra particulars.

Importing Legacy Constructed-in Parts

Traditionally, Ember purposes have been capable of import the bottom lessons which
outline <Enter>, <Textarea>, and <LinkTo> for reopening or subclassing. In
Ember 4.0, we intend to enhance the interior implementation of these built-ins.
To permit this, we have been steadily deprecating components of the built-in APIs
all through the three.x launch sequence.

In 3.27, importing a the bottom lessons of Ember built-ins is deprecated. In Ember
4.0 these modules shall be unavailable. The particular deprecated imports are:

import Checkbox from '@ember/part/checkbox';
import Textarea from '@ember/part/text-area';
import TextField from '@ember/part/text-field';
import LinkToComponent from '@ember/routing/link-component';

See the deprecation information
entry
for extra particulars and steerage on migrating away from these APIs.

Moreover, reopening these lessons (for instance to vary the tagName on a
<LinkTo>) has been deprecated and shall be unsupported in 4.0. See the
deprecation information for migration methods.

Deprecate Legacy Arguments to Constructed-ins

Ember’s built-in elements had a public interface largely outlined by their
implementation as traditional Ember elements. As a way to refactor these built-ins
to extra fashionable implementations and enhance their interfaces, massive components of
their API is deprecated in 3.27.

These deprecations break down into two sections. First, there are arguments
that are primarily setting HTML attributes or coping with occasions. See this
information entry on legacy attribute
arguments
for an in depth listing of deprecated arguments and migration paths.

Second, there’s a set of arguments which have been successfully leaks of the non-public
implementation, or which not have a transparent which means (or usefulness) in fashionable
software improvement. See this information entry on legacy arguments for an in depth listing and migration paths.

Deprecate the Ember World

Ember has lengthy set a property on the window or globalThis international in order that
it may be accessed through window.Ember, for instance. This strategy to utilizing Ember
is incompatible with static evaluation instruments that can lead to extra optimized
software payloads.

In Ember 3.27, accessing the Ember object through a non-module-import is
deprecated. Help for utilizing Ember this manner shall be eliminated in Ember 4.0.

As an alternative, purposes ought to undertake the Ember module API. This implies importing
both the Ember object or a selected API from the module API:

// Dangerous, deprecated
export default Ember.Part.lengthen({});

// Higher
import Ember from 'ember';
export default Ember.Part.lengthen({});

// Greatest
import Part from '@ember/part';
export default Part.lengthen({});

See the deprecation
information and RFC 706
for extra particulars and transition paths for different use circumstances.

Deprecate run loop and computed dot entry

Utilizing . to entry computed or run loop features has been deprecated, akin to computed.filter.
As an alternative, import the worth immediately from the module:

// Dangerous, deprecated
import EmberObject, { computed } from '@ember/object';

const Tomster = EmberObject.lengthen({
  readyForCamp: computed.and('hasTent', 'hasBackpack'),
  readyForHike: computed.and('hasWalkingStick', 'hasBackpack')
})

// Good
import EmberObject from '@ember/object';
import { and } from '@ember/object/computed';

class Tomster extends EmberObject {
  @and('hasTent', 'hasBackpack') readyForCamp;
  @and('hasWalkingStick', 'hasBackpack') readyForHike;
}

See the deprecation information.

Additional Info On Improve Timelines

For software maintainers who wish to improve apps to Ember.js 4.0 on its launch date, the listing of
deprecations on this launch means their problem is now properly outlined.
Utility maintainers ought to think about using the
ember-cli-deprecation-workflow
addon to handle deprecations incrementally after upgrading to three.27.
ember-cli-deprecation-workflow 2.0 was launched right this moment in preperation for
purposes addressing Ember 3.x deprecations. Give us suggestions within the points
on that repo.

For app maintainers who’re in much less of a rush, please notice that the upcoming
launch of Ember.js 3.28
will comprise no new deprecations concentrating on Ember.js 4.0. Moreover, Ember.js
3.28 shall be promoted to LTS on the identical day Ember.js 4.0 is launched.

We advocate that purposes utilizing LTS releases await the primary LTS of
Ember.js 4.x to improve, which shall be Ember.js 4.4. Ember’s 6 week launch
cycle means we count on there may be about 44 weeks (from right this moment) for apps upgrading from LTS-to-LTS
to handle 4.0-targeted deprecations earlier than Ember.js 4.4-LTS is made out there.

For extra particulars on adjustments in Ember.js 3.27, please assessment the Ember.js 3.27.5 launch web page.

Ember Information

Ember Information is the official knowledge persistence library for Ember.js purposes.
Ember Information’s 3.27 launch largely consists of compatability work with Ember.js.

For extra particulars on adjustments in Ember Information 3.27, please assessment the
Ember Information 3.27.0 launch web page.

Ember CLI

Ember CLI is the command line interface for managing and packaging Ember.js purposes.

Upgrading Ember CLI

You could improve Ember CLI utilizing the ember-cli-update venture:

npx ember-cli-update

This utility will assist you to to replace your app or addon to the newest Ember CLI model. You’ll in all probability encounter merge conflicts, through which the default habits is to allow you to resolve conflicts by yourself. For extra info on the ember-cli-update venture, see the GitHub README.

Whereas it’s endorsed to maintain Ember CLI variations in sync with Ember and Ember Information, this isn’t required. After updating ember-cli, you may maintain your present model(s) of Ember or Ember Information by enhancing package deal.json to revert the adjustments to the strains containing ember-source and ember-data.

Adjustments in Ember CLI 3.27

Ember CLI 3.27 introduces a flag for enabling Embroider (Ember CLI’s new construct
pipeline) for brand spanking new purposes and addons. For instance:

ember new my-app --embroider

Study extra about what Embroider gives and learn how to greatest configure it on the
embroider-build/embroider repo.

For extra particulars on adjustments and bugfixes in Ember CLI 3.27, see the Ember 3.27.0
changelog
and Ember CLI 3.27.0 launch web page.

Thank You!

As a community-driven open-source venture with an formidable scope, every of those releases serves as a reminder that the Ember venture wouldn’t have been attainable with out your continued help. We’re extraordinarily grateful to our contributors for his or her efforts.