ask-sdk V2中Request类型定义不完整，TypeScript访问request.intent报错

Ah, I’ve run into this exact TypeScript quirk with the Alexa ASK SDK v2 before! The error boils down to type safety rules—let’s break down why it pops up and how to fix it for good.

Why This Error Happens #

The Request type in the SDK is a union type that covers every possible Alexa request type (like LaunchRequest, IntentRequest, SessionEndedRequest, etc.). Only IntentRequest has the intent property, so TypeScript won’t let you access request.intent directly—it can’t confirm the request is actually an intent-focused one.

Fix 1: Let TypeScript Infer the Type (Cleanest Approach) #

Your code already checks if request.type === intents.type.IntentRequest—you just need to structure it so TypeScript can use that check to narrow the type. Wrap the intent name check inside an if block, and TypeScript will automatically recognize request as an IntentRequest within that scope:

canHandle(handlerInput: Alexa.HandlerInput) {
  const { request } = handlerInput.requestEnvelope;
  if (request.type === intents.type.IntentRequest) {
    return request.intent.name === intents.LocateBranch;
  }
  return false;
}

Fix 2: Use a Type Assertion (Quick One-Liner Fix) #

If you prefer to keep the logic in a single return statement, you can use a type assertion to tell TypeScript "trust me, this is an IntentRequest":

canHandle(handlerInput: Alexa.HandlerInput) {
  const { request } = handlerInput.requestEnvelope;
  return (
    request.type === intents.type.IntentRequest &&
    (request as Alexa.IntentRequest).intent.name === intents.LocateBranch
  );
}

Fix 3: Reusable Type Predicate (For Multiple Handlers) #

If you’re checking for IntentRequest across multiple handlers, create a helper function to streamline this. This is called a type predicate, and it explicitly teaches TypeScript how to identify an IntentRequest:

function isIntentRequest(request: Alexa.Request): request is Alexa.IntentRequest {
  return request.type === 'IntentRequest';
}

canHandle(handlerInput: Alexa.HandlerInput) {
  const { request } = handlerInput.requestEnvelope;
  return isIntentRequest(request) && request.intent.name === intents.LocateBranch;
}

All these approaches eliminate the type error while keeping your code strictly type-safe.

内容的提问来源于stack exchange，提问作者AkshayM