Basic Examples

In[]:=

Evaluate an expression when the Wolfram Language kernel session is terminated:

○
RunOnQuit
[Print["Bye!"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Quit[]
In[]:=
Bye!

Add multiple pieces of code:

○
RunOnQuit
[Print["first"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
○
RunOnQuit
[Print["second"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Quit[]
In[]:=
second
first

Scope

In[]:=

RunOnQuit[expr]
is similar to
$Epilog
:=expr
, but the file end.m is still read (if available):

Definition[$Epilog]
In[]:=
$Epilog:=If[FindFile[end`]=!=$Failed,<<end`]
Out[]=
○
RunOnQuit
[Print["Quitting!"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Definition[$Epilog]
In[]:=
$Epilog:=
○
RunOnQuit
[<>,Print[Quitting!],If[FindFile[end`]=!=$Failed,<<end`]]
Out[]=

Each time
RunOnQuit
is used, code is prepended to the sequence of evaluations in
$Epilog
:

○
RunOnQuit
[Print["first"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Definition[$Epilog]
In[]:=
$Epilog:=
○
RunOnQuit
[<>,Print[first],Print[Quitting!],If[FindFile[end`]=!=$Failed,<<end`]]
Out[]=
○
RunOnQuit
[Print["second"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Definition[$Epilog]
In[]:=
$Epilog:=
○
RunOnQuit
[<>,Print[second],Print[first],Print[Quitting!],If[FindFile[end`]=!=$Failed,<<end`]]
Out[]=
Quit[]
In[]:=
second
first
Quitting!

If
$Epilog
is undefined,
RunOnQuit[expr]
defines it:

$Epilog=.
In[]:=
○
RunOnQuit
[Print["Quitting"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Definition[$Epilog]
In[]:=
$Epilog:=
○
RunOnQuit
[<>,Print[Quitting]]
Out[]=

Evaluations will then be prepended as normal:

○
RunOnQuit
[Print["Run this first"]]
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=
Definition[$Epilog]
In[]:=
$Epilog:=
○
RunOnQuit
[<>,Print[Run this first],Print[Quitting]]
Out[]=
Quit[]
In[]:=
Run this first
Quitting

Applications

In[]:=

Create a notebook that only persists for the current kernel session:

With{nb=CreateWindow[]},​​
○
RunOnQuit
[Print["Closing notebook…"];NotebookClose[nb]]​​
In[]:=
Success
✓
Message: Handler added successfully
Tag: RunOnQuit
Out[]=

Make sure you are logged off from the cloud when the kernel quits:

Clean up any messes that you make:

Run all evaluations on quit:

Possible Issues

In[]:=