_init_self_delete intended for dummy clients which we call .delete() ourselves

evnchn · evnchn · commit 8414e1d9546c · 2025-11-09T17:13:45.000Z
diff --git a/nicegui/client.py b/nicegui/client.py
@@ -58,7 +58,7 @@ class Client:
     shared_body_html = ''
     '''HTML to be inserted in the <body> of every page template.'''
 
-    def __init__(self, page: page, *, request: Request | None = None) -> None:
+    def __init__(self, page: page, *, request: Request | None = None, _init_self_delete: bool = True) -> None:
         self._request = request
         self.id = str(uuid.uuid4())
         self.created = time.time()
@@ -101,7 +101,8 @@ def __init__(self, page: page, *, request: Request | None = None) -> None:
         with self:
             self.sub_pages_router = SubPagesRouter(request)
 
-        self._reset_self_delete(timeout=60.0)
+        if _init_self_delete:  # don't pass this unless you will call client.delete() yourself
+            self._reset_self_delete(timeout=60.0)
 
     @property
     def request(self) -> Request:
diff --git a/nicegui/context.py b/nicegui/context.py
@@ -21,7 +21,8 @@ def slot_stack(self) -> list[Slot]:
             from .page import page  # pylint: disable=import-outside-toplevel,cyclic-import
             if not Client.instances:  # in case some kind of dummy client is already created
                 core.script_mode = True
-                core.script_client = Client(page('/')).__enter__()  # pylint: disable=unnecessary-dunder-call
+                core.script_client = Client(
+                    page('/'), _init_self_delete=False).__enter__()  # pylint: disable=unnecessary-dunder-call
                 stack = Slot.get_stack()
         return stack
 
diff --git a/nicegui/ui_run.py b/nicegui/ui_run.py
@@ -131,7 +131,7 @@ def run_script() -> None:
             runpy.run_path(sys.argv[0], run_name='__main__')
         root = run_script
         assert core.script_client is not None
-        core.script_client.delete()
+        core.script_client.delete()  # hence why _init_self_delete=False
 
     core.app.config.add_run_config(
         reload=reload,
diff --git a/website/documentation/content/doc/api.py b/website/documentation/content/doc/api.py
@@ -27,10 +27,10 @@
 def dummy_client() -> Generator[Client, None, None]:
     """Create a dummy client for pre-rendering UI."""
     try:
-        with Client(nicegui_ui.page('')) as client:
+        with Client(nicegui_ui.page(''), _init_self_delete=False) as client:
             yield client
     finally:
-        client.delete()
+        client.delete()  # hence _init_self_delete=False above
 
 
 def auto_execute(function: Callable) -> Callable:
