Cloud tasks headers are not exposed

[REQUIRED] Version info

node: v18.13.0

firebase-functions: 4.1.1

firebase-tools: 11.20.0

firebase-admin: 11.4.1

[REQUIRED] Test case

https://firebase.google.com/docs/functions/task-functions#task_queue_configuration

onDispatch function is getting the task data but not the task headers.

firebase-functions/src/common/providers/tasks.ts

Lines 112 to 114 in 0b066d6

    
           export function onDispatchHandler<Req = any>( 
        
             handler: v1TaskHandler | v2TaskHandler<Req> 
        
           ): (req: https.Request, res: express.Response) => Promise<void> {

We noticed that the headers are exposed when triggered by HTTP target task handler (https://cloud.google.com/tasks/docs/creating-http-target-tasks#handler), and we expect to also get them via onDispatch handler context object.

It seems that the headers can be useful for various purposes.
As an example, We particularly interested in the X-CloudTasks-TaskExecutionCount header, as it would allow us to better understand how tasks are being executed.

[REQUIRED] Steps to reproduce

No steps to reproduce. Right now task headers are not accessible using onDispatch.

[REQUIRED] Expected behavior

Task headers to be exposed.

[REQUIRED] Actual behavior

Task headers are not exposed.

I found a few problems with this issue:

I couldn't figure out how to label this issue, so I've labeled it for a human to triage. Hang tight.
This issue does not seem to follow the issue template. Make sure you provide all the required information.

@AmichayMiara

Thanks for the feature request @AmichayMiara!

Internal note: similar to #1178

Hi all, is there any known planning on when this feature will be released?

This was actually released in https://github.com/firebase/firebase-functions/releases/tag/v4.5.0 (PR: #1423) and this issue can be closed.

@gustavopch

Closing as complete, thanks @gustavopch

Navigation Menu

Repository navigation

Cloud tasks headers are not exposed #1340

[REQUIRED] Version info

[REQUIRED] Test case

[REQUIRED] Steps to reproduce

[REQUIRED] Expected behavior

[REQUIRED] Actual behavior

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

	export function onDispatchHandler<Req = any>(
	handler: v1TaskHandler \| v2TaskHandler<Req>
	): (req: https.Request, res: express.Response) => Promise<void> {

Cloud tasks headers are not exposed #1340

Description

[REQUIRED] Version info

[REQUIRED] Test case

[REQUIRED] Steps to reproduce

[REQUIRED] Expected behavior

[REQUIRED] Actual behavior

Activity

google-oss-bot commented on Jan 19, 2023

taeold commented on Jan 19, 2023

sdegroot commented on Apr 13, 2023

gustavopch commented on Apr 6, 2024

cabljac commented on Jun 5, 2025

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions