How to access Actor input inside route handlers?

Hello, I am having trouble figuring out how to do the following, and cannot find anything in the docs:

Suppose I want to use variables provided in my input_schema, ex:

const {
    startUrls = [
        'https://enzosbbq.com/'
    ],
    proxyConfig = {
        useApifyProxy: true
    },
    maxRequestsPerCrawl = 100,
    navigationTimeoutSecs = 30,
} = await Actor.getInput<Input>() ?? {} as Input;

const {
    startUrls = [
        'https://enzosbbq.com/'
    ],
    proxyConfig = {
        useApifyProxy: true
    },
    maxRequestsPerCrawl = 100,
    navigationTimeoutSecs = 30,
} = await Actor.getInput<Input>() ?? {} as Input;

Inside of my route handlers, ex

export const router = createPlaywrightRouter()

router.addHandler("test-handler", async (ctx) => {
  // TODO how do I access input variables here?
})

export const router = createPlaywrightRouter()

router.addHandler("test-handler", async (ctx) => {
  // TODO how do I access input variables here?
})

How can I access input variables inside of my route handlers?

Oleg V.•3/4/24, 2:35 PM

You can pass input via userData (https://crawlee.dev/api/core/interface/RequestOptions#userData)

And then get it in Your handler like this:

embarrassing-maroonOP•3/5/24, 1:15 AM

Will crawler.run accept the dict format for startUrls vs raw strings?

const crawler = new PlaywrightCrawler({
proxyConfiguration,
maxRequestsPerCrawl,
navigationTimeoutSecs,
requestHandler: router,
});

await crawler.run(startUrls);

Oleg V.•3/5/24, 11:17 AM

Here are docs with all types:
https://crawlee.dev/api/playwright-crawler/class/PlaywrightCrawler#run

requests: (string | Request<Dictionary> | RequestOptions<Dictionary>)[]

embarrassing-maroonOP•3/6/24, 3:57 AM

Thanks for the info. I am still having trouble. When providing a valid RequestOptions object into the start urls array and passing it to crawler.run, request.userData is still an empty dict.

Main.ts:

routes.ts

embarrassing-maroonOP•3/6/24, 4:38 AM

Is there another way to achieve this with useState? I cannot find any examples which show how to define state in main.ts then use the defined state in route.ts

embarrassing-maroonOP•3/6/24, 5:14 AM

Edit: The issue was related to me importing a type defined in my main.ts file in route.ts. I am able to get this working now. Thanks!

I am still confused as to how I can define state using useState in main.ts, then access this state in my route.ts

embarrassing-maroonOP•3/6/24, 5:23 AM

this approach would actually be preferred for me since I want to be able to set global configuration that I can reference in state in each of my route handlers. I attempted to define the state in my main.ts file

`export const state = useState("socialsConfig:", socialsConfig)'

But how can I use this state in my route handlers in route.ts? I tried importing state, but this casued a cyclic dependency.

Oleg V.•3/6/24, 10:45 AM

You don't need to export it from main.
Here is working example:

embarrassing-maroonOP•3/7/24, 5:12 AM

I copied this code verbatem, and playwrightDetails is undefined in my route.ts

MEE6•3/7/24, 5:12 AM

@sunlover just advanced to level 2! Thanks for your contributions!

embarrassing-maroonOP•3/7/24, 5:18 AM

Do you know why this may be?

embarrassing-maroonOP•3/7/24, 5:26 AM

Here is my exact code

main.ts

routes.ts

embarrassing-maroonOP•3/7/24, 5:26 AM

Nomatter what I do, the state in routes.ts is always undefined

Oleg V.•3/7/24, 10:01 AM

You should move

to

embarrassing-maroonOP•3/8/24, 3:48 AM

Thanks I got it working @Oleg V.

clean-aquamarine•4/3/25, 8:23 AM

why is that hard to find this informations on crawlee docs

MEE6•4/3/25, 8:23 AM

@Scai just advanced to level 2! Thanks for your contributions!

clean-aquamarine•4/3/25, 8:24 AM

I've got it to working as the way I wanted.