From 1b3a272970852d5933baf79b8f3b13458e0168ff Mon Sep 17 00:00:00 2001 From: Peter Wagenet Date: Fri, 13 Jun 2025 12:44:49 -0700 Subject: [PATCH 1/2] Deprecate Ember Proxies --- text/1112-deprecate-proxy.md | 70 ++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 text/1112-deprecate-proxy.md diff --git a/text/1112-deprecate-proxy.md b/text/1112-deprecate-proxy.md new file mode 100644 index 0000000000..25b7c43cea --- /dev/null +++ b/text/1112-deprecate-proxy.md @@ -0,0 +1,70 @@ +--- +stage: accepted +start-date: 2025-06-13T00:00:00.000Z +release-date: +release-versions: +teams: # delete teams that aren't relevant + - cli + - data + - framework + - learning + - steering + - typescript +prs: + accepted: https://github.com/emberjs/rfcs/pull/1112 +project-link: +--- + + + +# Deprecating Ember Proxies + +## Summary + +Now that Native Proxy is available in all supported environments, we can deprecate +Ember's custom Proxy handling provided by `ArrayProxy`, `ObjectProxy`, and `PromiseProxyMixin`. + +## Motivation + +These patterns were introduce to Ember prior to the availability of Native Proxy. Since +Native Proxy is now available in all supported environments, we can deprecate these +patterns in favor of the native Proxy API. + +Additionally, we would like to deprecate Mixins in the future necessitating that we first +deprecate `PromiseProxyMixin`. + +## Transition Path + +There is no direct migration path for these. Code that relies upon this behavior will have to be rewritten. + +## Exploration + +To validate this deprecation, I've tried removing the assocaited functionality in this PR: +https://github.com/emberjs/ember.js/pull/20918 + +## How We Teach This + +We should remove references to these patterns from the guides. + +## Drawbacks + +By not providing a direct replacement some users may have difficulty migrating. + +## Alternatives + +None + +## Unresolved questions + +None From 7d9a97d5b95ce054e418c818bc616dd445222872 Mon Sep 17 00:00:00 2001 From: Katie Gengler Date: Fri, 8 Aug 2025 14:58:19 -0400 Subject: [PATCH 2/2] Update text/1112-deprecate-proxy.md Co-authored-by: NullVoxPopuli <199018+NullVoxPopuli@users.noreply.github.com> --- text/1112-deprecate-proxy.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/text/1112-deprecate-proxy.md b/text/1112-deprecate-proxy.md index 25b7c43cea..b02fe1c2b3 100644 --- a/text/1112-deprecate-proxy.md +++ b/text/1112-deprecate-proxy.md @@ -48,6 +48,8 @@ deprecate `PromiseProxyMixin`. There is no direct migration path for these. Code that relies upon this behavior will have to be rewritten. +See the deprecation guide (PR'd here: https://github.com/ember-learn/deprecation-app/pull/1405 ) + ## Exploration To validate this deprecation, I've tried removing the assocaited functionality in this PR: