Prop types and validation in Vue

Introduction

Props let you pass data to components. Validation helps catch mistakes early by checking the data type and rules.

When you want to send information from a parent component to a child component.

When you want to make sure the data passed to a component is the right type.

When you want to provide default values for props if none are given.

When you want to give clear errors or warnings if wrong data is passed.

When you want to document what kind of data a component expects.

Syntax

Vue

props: {
  propName: {
    type: [String, Number, Boolean, Array, Object, Function, Date, Symbol],
    required: true | false,
    default: defaultValue,
    validator: (value) => boolean
  }
}

The type checks the kind of data passed.

The validator is a function to add custom checks.

Examples

Simple prop expecting a string.

Vue

props: {
  title: String
}

Prop that must be a number and is required.

Vue

props: {
  count: {
    type: Number,
    required: true
  }
}

Prop with default value and custom validation to allow only certain strings.

Vue

props: {
  status: {
    type: String,
    default: 'active',
    validator: value => ['active', 'inactive'].includes(value)
  }
}

Sample Program

This component expects three props: title (string, required), count (number, required), and status (string with default and validation). It shows them in the template.

Vue

<template>
  <div>
    <h2>{{ title }}</h2>
    <p>Count: {{ count }}</p>
    <p>Status: {{ status }}</p>
  </div>
</template>

<script setup>
import { defineProps } from 'vue'

const props = defineProps({
  title: {
    type: String,
    required: true
  },
  count: {
    type: Number,
    required: true
  },
  status: {
    type: String,
    default: 'active',
    validator: value => ['active', 'inactive'].includes(value)
  }
})
</script>

Important Notes

If a required prop is missing or a prop fails validation, Vue will show a warning in the browser console.

Default values are used only if the prop is not provided.

Use validator for rules that type can't check, like allowed strings.

Summary

Props pass data from parent to child components.

Validation helps catch errors by checking type, required status, default values, and custom rules.

Vue shows warnings if props don't match the rules, helping you fix bugs early.

Practice

1. What is the main purpose of defining props with types in a Vue component?

easy

A. To ensure the component receives data in the expected format

B. To style the component automatically

C. To make the component load faster

D. To prevent the component from rendering

Solution

1. Step 1: Understand what props do in Vue

   Props allow passing data from a parent to a child component.

2. Step 2: Recognize the role of prop types

   Defining types helps Vue check if the data matches the expected format, catching errors early.

3. Final Answer:

   To ensure the component receives data in the expected format -> Option A

4. Quick Check:

   Prop types = data format check [OK]

Hint: Prop types check data format passed to components [OK]

Common Mistakes:

• Thinking prop types affect styling
• Believing prop types improve speed
• Assuming prop types stop rendering

2. Which of the following is the correct syntax to define a required string prop named title in a Vue component?

easy

A. props: { title: String, required: true }

B. props: { title: { type: String, required: true } }

C. props: { title: { required: true type: String } }

D. props: { title: { String, required: true } }

Solution

1. Step 1: Recall Vue prop syntax for validation

   Props with validation use an object with keys like type and required.

2. Step 2: Check the correct order and structure

   The correct syntax is { type: String, required: true } inside the prop definition.

3. Final Answer:

   props: { title: { type: String, required: true } } -> Option B

4. Quick Check:

   Prop validation uses object with type and required [OK]

Hint: Use object with type and required keys for prop validation [OK]

Common Mistakes:

• Placing required outside the prop object
• Using array instead of object for validation
• Wrong order or missing keys in prop definition

3. Given this Vue component prop definition:

props: { count: { type: Number, default: 0 } }

What will be the value of count inside the component if the parent does NOT pass any count prop?

medium

A. 0

B. null

C. undefined

D. NaN

Solution

1. Step 1: Understand default prop values

   If a prop is not passed, Vue uses the default value if defined.

2. Step 2: Check the default value for count

   The default is set to 0, so count will be 0 inside the component.

3. Final Answer:

   0 -> Option A

4. Quick Check:

   Missing prop uses default value [OK]

Hint: Default prop value used if parent omits prop [OK]

Common Mistakes:

• Assuming undefined if prop is missing
• Confusing null with default value
• Expecting error when prop is missing

4. Consider this prop validation in a Vue component:

props: { age: { type: Number, required: true } }

What will happen if the parent passes age="twenty" (a string) instead of a number?

medium

A. Vue will automatically convert the string to a number

B. Vue will throw a runtime error and stop rendering

C. Vue will show a console warning about the type mismatch

D. Vue will ignore the prop and use the default value

Solution

1. Step 1: Understand Vue's prop type checking behavior

   Vue checks prop types and warns in the console if types don't match but does not stop rendering.

2. Step 2: Check what happens with wrong type

   Passing a string instead of a number triggers a console warning but no error or conversion.

3. Final Answer:

   Vue will show a console warning about the type mismatch -> Option C

4. Quick Check:

   Wrong prop type triggers warning, not error [OK]

Hint: Vue warns on wrong prop types but keeps rendering [OK]

Common Mistakes:

• Expecting runtime errors instead of warnings
• Thinking Vue auto-converts prop types
• Assuming default value is used on type mismatch

5. You want to validate a prop status that only accepts the strings 'active', 'inactive', or 'pending'. Which is the correct way to add this validation in Vue?

hard

A. props: { status: { type: String, validate: value => ['active', 'inactive', 'pending'].includes(value) } }"

B. props: { status: { type: String, required: true, default: 'active' } }

C. props: { status: { type: String, enum: ['active', 'inactive', 'pending'] } }

D. props: { status: { type: String, validator: value => ['active', 'inactive', 'pending'].includes(value) } }

Solution

1. Step 1: Recall how to restrict prop values in Vue

   Vue uses a validator function to check if a prop value is allowed.

2. Step 2: Check the correct validator syntax

   The validator is a function returning true if the value is valid, like value => ['active', 'inactive', 'pending'].includes(value).

3. Final Answer:

   props: { status: { type: String, validator: value => ['active', 'inactive', 'pending'].includes(value) } } -> Option D

4. Quick Check:

   Use validator function to restrict prop values [OK]

Hint: Use validator function to limit allowed prop values [OK]

Common Mistakes:

• Using non-existent 'enum' key for props
• Confusing 'validate' with 'validator'
• Relying only on default or required without value check