Scala 3中如何为原生JS trait实现动态接口？

问题背景 #

在Scala 2中，我们可以为three.js的Uniforms定义如下外观特征（facade trait），同时支持括号访问（u("opacity").value = 0.5）和动态属性访问（u.opacity.value = 0.5）：

@js.native
trait Uniforms extends js.Object with Dynamic {
  @JSBracketAccess
  def update(name: String, uniform: Uniform): Unit
  @JSBracketAccess
  def apply(name: String): Uniform

  @JSName("remove")
  def -=(name: String): Uniform

  @JSBracketAccess
  def selectDynamic(name: String): Uniform
  @JSBracketAccess
  def updateDynamic(name: String)(value: Uniform): Unit
}

但迁移到Scala 3后，这段代码编译能通过，但在fastOptJS链接阶段会报错：

[error] scala.Dynamic (of kind Interface) is not a valid interface implemented by threejs.Uniforms (of kind AbstractJSType)
[error] called from threejs.Uniforms

由于js.Dynamic是密封类无法直接继承，需要找到Scala 3中为原生JS类型定义支持Dynamic用法的外观特征的方法。

解决方案 #

在Scala 3中，JS外观特征不能直接继承Dynamic，但可以通过扩展方法模拟Dynamic的行为，同时保留JS原生类型的兼容性：

1. 定义基础Uniforms外观特征 #

先移除Dynamic继承，只保留JS原生相关的注解与方法：

@js.native
trait Uniforms extends js.Object {
  @JSBracketAccess
  def update(name: String, uniform: Uniform): Unit
  @JSBracketAccess
  def apply(name: String): Uniform

  @JSName("remove")
  def -=(name: String): Uniform
}

2. 添加Dynamic风格的扩展方法 #

在同一包下定义扩展方法，实现selectDynamic和updateDynamic的等效功能，让我们可以像访问属性一样操作Uniforms：

extension (uniforms: Uniforms)
  def selectDynamic(name: String): Uniform = uniforms(name)
  def updateDynamic(name: String)(value: Uniform): Unit = uniforms.update(name, value)

使用方式 #

现在两种访问方式依然可以正常工作：

• 括号访问：u("opacity").value = 0.5
• 动态属性访问：u.opacity.value = 0.5

这种方式既避开了Scala 3中JS类型不能继承Dynamic的限制，又完全保留了原有的使用体验，且链接阶段不会再出现错误。

内容的提问来源于stack exchange，提问作者Suma