Render children passed to "backwards" SuspenseList in reverse mount order (#35021)

Stacked on #35018.
This mounts the children of SuspenseList backwards. Meaning the first
child is mounted last in the DOM (and effect list). It's like calling
reverse() on the children.
This is meant to set us up for allowing AsyncIterable children where the
unknown number of children streams in at the end (which is the beginning
in a backwards SuspenseList). For consistency we do that with other
children too.
`unstable_legacy-backwards` still exists for the old mode but is meant
to be deprecated.
<img width="100" alt="image"
src="https://github.com/user-attachments/assets/5c2a95d7-34c4-4a4e-b602-3646a834d779"
/>

Author: sebmarkbage

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,

packages/react-dom/src/__tests__/ReactDOMFizzSuspenseList-test.js

@@ -656,6 +656,77 @@ describe('ReactDOMFizzSuspenseList', () => {
 );
 });
 
+// @gate enableSuspenseList
+it('displays each items in "backwards" mount order',async()=>{
+constA=createAsyncText('A');
+constB=createAsyncText('B');
+constC=createAsyncText('C');
+
+functionFoo(){
+return(
+<div>
+<SuspenseListrevealOrder="backwards"tail="visible">
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading B"/>}>
+<B/>
+</Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
+</SuspenseList>
+</div>
+);
+}
+
+awaitA.resolve();
+
+awaitserverAct(async()=>{
+const{pipe}=ReactDOMFizzServer.renderToPipeableStream(<Foo/>);
+pipe(writable);
+});
+
+assertLog([
+'Suspend! [C]',
+'Suspend! [B]',// TODO: Defer rendering the content after fallback if previous suspended,
+'A',
+'Loading C',
+'Loading B',
+'Loading A',
+]);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>Loading C</span>
+</div>,
+);
+
+awaitserverAct(()=>C.resolve());
+assertLog(['C']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>Loading A</span>
+<span>Loading B</span>
+<span>C</span>
+</div>,
+);
+
+awaitserverAct(()=>B.resolve());
+assertLog(['B']);
+
+expect(getVisibleChildren(container)).toEqual(
+<div>
+<span>A</span>
+<span>B</span>
+<span>C</span>
+</div>,
+);
+});
+
 // @gate enableSuspenseList
 it('displays each items in "backwards" order in legacy mode',async()=>{
 constA=createAsyncText('A');
@@ -737,15 +808,13 @@ describe('ReactDOMFizzSuspenseList', () => {
 return(
 <div>
 <SuspenseListrevealOrder="forwards"tail="visible">
-<SuspenseList
-revealOrder="unstable_legacy-backwards"
-tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
-</Suspense>
+<SuspenseListrevealOrder="backwards"tail="visible">
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
+</Suspense>
 </SuspenseList>
 <Suspensefallback={<Texttext="Loading C"/>}>
 <C/>

packages/react-reconciler/src/ReactFiberBeginWork.js

@@ -3247,18 +3247,14 @@ function validateRevealOrder(revealOrder: SuspenseListRevealOrder) {
 if(
 revealOrder!=null&&
 revealOrder!=='forwards'&&
+revealOrder!=='backwards'&&
 revealOrder!=='unstable_legacy-backwards'&&
 revealOrder!=='together'&&
 revealOrder!=='independent'&&
 !didWarnAboutRevealOrder[cacheKey]
 ){
 didWarnAboutRevealOrder[cacheKey]=true;
-if(revealOrder==='backwards'){
-console.error(
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify revealOrder="legacy_unstable-backwards" instead.',
-);
-}elseif(typeofrevealOrder==='string'){
+if(typeofrevealOrder==='string'){
 switch(revealOrder.toLowerCase()){
 case'together':
 case'forwards':
@@ -3371,6 +3367,17 @@ function initSuspenseListRenderState(
 }
 }
 
+functionreverseChildren(fiber: Fiber): void{
+letrow=fiber.child;
+fiber.child=null;
+while(row!==null){
+constnextRow=row.sibling;
+row.sibling=fiber.child;
+fiber.child=row;
+row=nextRow;
+}
+}
+
 // This can end up rendering this component multiple passes.
 // The first pass splits the children fibers into two sets. A head and tail.
 // We first render the head. If anything is in fallback state, we do another
@@ -3409,7 +3416,16 @@ function updateSuspenseListComponent(
 validateTailOptions(tailMode,revealOrder);
 validateSuspenseListChildren(newChildren,revealOrder);
 
-reconcileChildren(current,workInProgress,newChildren,renderLanes);
+if(revealOrder==='backwards'&&current!==null){
+// For backwards the current mounted set will be backwards. Reconciling against it
+// will lead to mismatches and reorders. We need to swap the original set first
+// and then restore it afterwards.
+reverseChildren(current);
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+reverseChildren(current);
+}else{
+reconcileChildren(current,workInProgress,newChildren,renderLanes);
+}
 // Read how many children forks this set pushed so we can push it every time we retry.
 consttreeForkCount=getIsHydrating() ? getForksAtLevel(workInProgress) : 0;
 
@@ -3434,7 +3450,37 @@ function updateSuspenseListComponent(
 workInProgress.memoizedState=null;
 }else{
 switch(revealOrder){
-case'backwards':
+case'backwards': {
+// We're going to find the first row that has existing content.
+// We are also going to reverse the order of anything in the existing content
+// since we want to actually render them backwards from the reconciled set.
+// The tail is left in order, because it'll be added to the front as we
+// complete each item.
+constlastContentRow=findLastContentRow(workInProgress.child);
+lettail;
+if(lastContentRow===null){
+// The whole list is part of the tail.
+tail=workInProgress.child;
+workInProgress.child=null;
+}else{
+// Disconnect the tail rows after the content row.
+// We're going to render them separately later in reverse order.
+tail=lastContentRow.sibling;
+lastContentRow.sibling=null;
+// We have to now reverse the main content so it renders backwards too.
+reverseChildren(workInProgress);
+}
+// TODO: If workInProgress.child is null, we can continue on the tail immediately.
+initSuspenseListRenderState(
+workInProgress,
+true,// isBackwards
+tail,
+null,// last
+tailMode,
+treeForkCount,
+);
+break;
+}
 case'unstable_legacy-backwards': {
 // We're going to find the first row that has existing content.
 // At the same time we're going to reverse the list of everything

packages/react-reconciler/src/ReactFiberCompleteWork.js

@@ -1838,10 +1838,6 @@ function completeWork(
 }
 }
 if(renderState.isBackwards){
-// The effect list of the backwards tail will have been added
-// to the end. This breaks the guarantee that life-cycles fire in
-// sibling order but that isn't a strong guarantee promised by React.
-// Especially since these might also just pop in during future commits.
 // Append to the beginning of the list.
 renderedTail.sibling=workInProgress.child;
 workInProgress.child=renderedTail;

packages/react-reconciler/src/__tests__/ReactSuspenseList-test.js

@@ -1022,22 +1022,22 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('warns if revealOrder="backwards" is specified',async()=>{
+it('displays each items in "backwards" order',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');
 
 functionFoo(){
 return(
 <SuspenseListrevealOrder="backwards"tail="visible">
-<Suspensefallback={<Texttext="Loading A"/>}>
-<A/>
+<Suspensefallback={<Texttext="Loading C"/>}>
+<C/>
 </Suspense>
 <Suspensefallback={<Texttext="Loading B"/>}>
 <B/>
 </Suspense>
-<Suspensefallback={<Texttext="Loading C"/>}>
-<C/>
+<Suspensefallback={<Texttext="Loading A"/>}>
+<A/>
 </Suspense>
 </SuspenseList>
 );
@@ -1056,14 +1056,6 @@ describe('ReactSuspenseList', () => {
 'Suspend! [C]',
 ]);
 
-assertConsoleErrorDev([
-'The rendering order of <SuspenseList revealOrder="backwards"> is changing. '+
-'To be future compatible you must specify '+
-'revealOrder="legacy_unstable-backwards" instead.'+
-'\n in SuspenseList (at **)'+
-'\n in Foo (at **)',
-]);
-
 expect(ReactNoop).toMatchRenderedOutput(
 <>
 <span>Loading A</span>
@@ -1101,7 +1093,7 @@ describe('ReactSuspenseList', () => {
 });
 
 // @gate enableSuspenseList
-it('displays each items in "backwards" order',async()=>{
+it('displays each items in "backwards" order (legacy)',async()=>{
 constA=createAsyncText('A');
 constB=createAsyncText('B');
 constC=createAsyncText('C');

packages/react-server/src/ReactFizzServer.js

@@ -2017,7 +2017,11 @@ function renderSuspenseListRows(
 constparentSegment=task.blockedSegment;
 constchildIndex=parentSegment.children.length;
 constinsertionIndex=parentSegment.chunks.length;
-for(leti=totalChildren-1;i>=0;i--){
+for(letn=0;n<totalChildren;n++){
+consti=
+revealOrder==='unstable_legacy-backwards'
+ ? totalChildren-1-n
+ : n;
 constnode=rows[i];
 task.row=previousSuspenseListRow=createSuspenseListRow(
 previousSuspenseListRow,