Merge pull request #6875 from dmarth/feature-filebrowser-location-par…

…ameter

accept query parameter to optionally change file browser location

docs/source/user/urls.rst

@@ -24,6 +24,16 @@ the nomenclature of the classic notebook; these URLs are ``/tree`` URLs:
 Entering this URL will open the notebook in JupyterLab in
 :ref:`single-document mode <tabs>`.
 
+By default, the file browser will navigate to the directory containing the requested
+file. This behavior can be changed with the optional ``file-browser-path`` query parameter:
+
+.. code-block:: none
+
+  http(s)://<server:port>/<lab-location>/lab/tree/path/to/notebook.ipynb?file-browser-path=/
+
+Entering the above URL will show the workspace root directory instead of the ``/path/to/``
+directory in the file browser.
+
 
 .. _url-workspaces-ui:
 

packages/application-extension/src/index.tsx

@@ -262,7 +262,7 @@ const tree: JupyterFrontEndPlugin<void> = {
         const treeMatch = args.path.match(treePattern);
         const workspaceMatch = args.path.match(workspacePattern);
         const match = treeMatch || workspaceMatch;
-        const path = decodeURI(match[1]);
+        let path = decodeURI(match[1]);
         // const { page, workspaces } = info.urls;
         const workspace = PathExt.basename(resolver.name);
         const url =
@@ -275,6 +275,11 @@ const tree: JupyterFrontEndPlugin<void> = {
         // Remove the tree portion of the URL leaving the rest intact.
         router.navigate(url);
 
+        const query = URLExt.queryStringToObject(args.search);
+        if (query['file-browser-path']) {
+          path = query['file-browser-path'];
+        }
+
         try {
           await commands.execute('filebrowser:open-path', { path });
         } catch (error) {