Aller au contenu principal

@babel/plugin-transform-class-properties

Traduction Bêta Non Officielle

Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →

info

Ce plugin est inclus dans @babel/preset-env, dans ES2022

Exemple​

Voici une classe avec quatre propriétés de classe qui seront transformées.

JavaScript
class Bork {
  //Property initializer syntax
  instanceProperty = "bork";
  boundFunction = () => {
    return this.instanceProperty;
  };

  //Static class properties
  static staticProperty = "babelIsCool";
  static staticFunction = function() {
    return Bork.staticProperty;
  };
}

let myBork = new Bork();

//Property initializers are not on the prototype.
console.log(myBork.__proto__.boundFunction); // > undefined

//Bound functions are bound to the class instance.
console.log(myBork.boundFunction.call(undefined)); // > "bork"

//Static function exists on the class.
console.log(Bork.staticFunction()); // > "babelIsCool"

Installation​

npm install --save-dev @babel/plugin-transform-class-properties

Utilisation​

Avec un fichier de configuration (Recommandé)​

Sans options :

babel.config.json
{
  "plugins": ["@babel/plugin-transform-class-properties"]
}

Avec options :

babel.config.json
{
  "plugins": [["@babel/plugin-transform-class-properties", { "loose": true }]]
}

Via CLI​

Shell
babel --plugins @babel/plugin-transform-class-properties script.js

Via l'API Node​

JavaScript
require("@babel/core").transformSync("code", {
  plugins: ["@babel/plugin-transform-class-properties"],
});

Options​

loose​

boolean, valeur par défaut : false.

Lorsque true, les propriétés de classe sont compilées en utilisant une expression d'assignation au lieu de Object.defineProperty.

attention

Envisagez de migrer vers l'hypothèse de haut niveau setPublicClassFields

babel.config.json
{
  "assumptions": {
    "setPublicClassFields": true
  }
}

Pour une explication des conséquences de chaque approche, consultez Definition vs. Assignment (TL;DR dans la partie 5)

Exemple​

JavaScript
class Bork {
  static a = "foo";
  static b;

  x = "bar";
  y;
}

Lorsque setPublicClassFields est false, le code ci-dessus sera compilé comme suit en utilisant Object.defineProperty :

JavaScript
var Bork = function Bork() {
  babelHelpers.classCallCheck(this, Bork);
  Object.defineProperty(this, "x", {
    configurable: true,
    enumerable: true,
    writable: true,
    value: "bar",
  });
  Object.defineProperty(this, "y", {
    configurable: true,
    enumerable: true,
    writable: true,
    value: void 0,
  });
};

Object.defineProperty(Bork, "a", {
  configurable: true,
  enumerable: true,
  writable: true,
  value: "foo",
});
Object.defineProperty(Bork, "b", {
  configurable: true,
  enumerable: true,
  writable: true,
  value: void 0,
});

Lorsque setPublicClassFields est défini à true, il sera compilé en utilisant des expressions d'assignation :

JavaScript
var Bork = function Bork() {
  babelHelpers.classCallCheck(this, Bork);
  this.x = "bar";
  this.y = void 0;
};

Bork.a = "foo";
Bork.b = void 0;
astuce

Vous pouvez en savoir plus sur la configuration des options de plugin ici

Références​