SupervisorJob for independent failure in Kotlin - Step-by-Step Execution

Concept Flow - SupervisorJob for independent failure

Start SupervisorJob

↓

Launch Child 1

↓

Launch Child 2

↓

Child 1 Fails?

Yes→Child 2 continues

↓

Child 2 completes

↓

SupervisorJob completes

↓

Parent Coroutine completes

SupervisorJob lets child coroutines fail independently without cancelling siblings or the parent.

Execution Sample

Kotlin

val supervisor = SupervisorJob()
val scope = CoroutineScope(supervisor)
scope.launch { throw Exception("Fail 1") }
scope.launch { delay(100); println("Child 2 done") }

Two child coroutines run under SupervisorJob; one fails, the other completes normally.

Execution Table

Step	Action	Child 1 State	Child 2 State	SupervisorJob State	Output
1	Start SupervisorJob and CoroutineScope	Not started	Not started	Active
2	Launch Child 1	Running	Not started	Active
3	Launch Child 2	Running	Running	Active
4	Child 1 throws Exception	Failed	Running	Active	Exception("Fail 1") thrown
5	Child 2 continues after delay	Failed	Running	Active
6	Child 2 prints message	Failed	Completed	Active	Child 2 done
7	SupervisorJob completes after children finish	Failed	Completed	Completed
8	Parent CoroutineScope completes	Failed	Completed	Completed

💡 Child 1 failure does not cancel Child 2 or SupervisorJob; all complete independently.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	After Step 6	Final
Child 1 State	Not started	Running	Running	Failed	Failed	Failed
Child 2 State	Not started	Not started	Running	Running	Completed	Completed
SupervisorJob State	Active	Active	Active	Active	Active	Completed

Key Moments - 2 Insights

Why does Child 2 keep running even though Child 1 failed?

Because SupervisorJob isolates failures; as shown in step 4 and 5 of execution_table, Child 1 fails but SupervisorJob stays active and Child 2 continues.

Does the failure of Child 1 cancel the SupervisorJob?

No, SupervisorJob remains active until all children complete, as seen in step 7 where SupervisorJob completes only after Child 2 finishes.

Visual Quiz - 3 Questions

Look at the execution_table, what is the state of Child 1 at step 5?

A Running

B Failed

C Completed

D Not started

💡 Hint

Check the 'Child 1 State' column at step 5 in execution_table.

At which step does Child 2 print its message?

A Step 4

B Step 5

C Step 6

D Step 7

💡 Hint

Look for the 'Output' column mentioning 'Child 2 done' in execution_table.

If SupervisorJob was replaced with a regular Job, what would happen after Child 1 fails?

A SupervisorJob cancels Child 2

B Parent CoroutineScope completes immediately

C Child 2 continues running

D Nothing changes

💡 Hint

Recall SupervisorJob isolates failures; a regular Job cancels siblings on failure.

Concept Snapshot

SupervisorJob lets child coroutines fail independently.
Failure in one child does NOT cancel siblings or the parent.
Use CoroutineScope(SupervisorJob()) to isolate failures.
Child coroutines run concurrently; failures are isolated.
SupervisorJob completes only after all children finish.

Full Transcript

This visual trace shows how SupervisorJob manages child coroutine failures independently. We start a SupervisorJob and launch two child coroutines. Child 1 throws an exception and fails, but Child 2 continues running and completes successfully. The SupervisorJob remains active until all children finish, then completes. This means failure in one child does not cancel others or the parent scope. The variable tracker confirms the states of children and SupervisorJob at each step. Key moments clarify why Child 2 is unaffected by Child 1's failure. The quiz tests understanding of states and SupervisorJob behavior. This helps beginners see how SupervisorJob isolates failures in Kotlin coroutines.