Fix theUserOpensTheFileOrFolderUsingTheWebUI so it opens a file

[phil-davis]

Description

1. Adjust the PHPdoc and method name so future readers will realize easily that it can be used to open a file or a folder.
2. Refactor so that if you pass in a path and say it is to a file, it will first navigate into any folders in the path and then open the file.
3. Make sure to remember the correct folders that were navigated into.

Related Issue

#34254

Motivation and Context

files_texteditor webUI acceptance tests are failing. Make them great again.

How Has This Been Tested?

Local runs of files_texteditor webUI acceptance tests

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Technical debt
• Tests

Checklist:

• Code changes
• Unit tests added
• Acceptance tests added
• Documentation ticket raised:

Open tasks:

• Backport (if applicable set "backport-request" label and remove when the backport was done)

[codecov]

Codecov Report

Merging #34253 into master will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##             master   #34253   +/-   ##
=========================================
  Coverage     64.76%   64.76%           
  Complexity    18363    18363           
=========================================
  Files          1198     1198           
  Lines         69538    69538           
  Branches       1281     1281           
=========================================
  Hits          45035    45035           
  Misses        24130    24130           
  Partials        373      373

Flag	Coverage Δ	Complexity Δ
#javascript	53.09% <ø> (ø)	0 <ø> (ø)	⬇️
#phpunit	66.11% <ø> (ø)	18363 <ø> (ø)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 01f927d...5f32b04. Read the comment docs.

[codecov]

Codecov Report

Merging #34253 into master will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##             master   #34253   +/-   ##
=========================================
  Coverage     64.76%   64.76%           
  Complexity    18363    18363           
=========================================
  Files          1198     1198           
  Lines         69538    69538           
  Branches       1281     1281           
=========================================
  Hits          45035    45035           
  Misses        24130    24130           
  Partials        373      373

Flag	Coverage Δ	Complexity Δ
#javascript	53.09% <ø> (ø)	0 <ø> (ø)	⬇️
#phpunit	66.11% <ø> (ø)	18363 <ø> (ø)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 01f927d...f529a20. Read the comment docs.

[phil-davis]

Backport stable10 #34259

[phil-davis]

I need to push this to run CI again in the hope of getting codecov.
PITA having drone passed but can't merge.