Accessing form data in routes in Flask

Introduction

We use form data in routes to get information users type into a web form. This helps the app respond to user input.

When a user submits a login form with username and password.

When a visitor fills out a contact form on a website.

When a user posts a comment or feedback on a blog.

When a user uploads data through a form to update their profile.

Syntax

Flask

from flask import request

@app.route('/submit', methods=['POST'])
def submit():
    value = request.form['field_name']
    # use value as needed

request.form holds form data sent by POST method.

You can access form fields by their name attribute.

Examples

Get the value of the form field named 'username'.

Flask

username = request.form['username']

Get 'email' field value or use a default if missing.

Flask

email = request.form.get('email', '[e-mail]')

Check if password was provided and handle missing data.

Flask

password = request.form.get('password')
if not password:
    return 'Password is required', 400

Sample Program

This Flask app shows a login form on GET. On POST, it reads username and password from the form data and greets the user if both are provided.

Flask

from flask import Flask, request

app = Flask(__name__)

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        username = request.form.get('username')
        password = request.form.get('password')
        if username and password:
            return f'Welcome, {username}!'
        else:
            return 'Missing username or password', 400
    return '''
        <form method="post">
            Username: <input type="text" name="username"><br>
            Password: <input type="password" name="password"><br>
            <input type="submit" value="Login">
        </form>
    '''

Important Notes

Always check if form fields exist to avoid errors.

Use request.form.get() to safely access fields with a default.

Form data is only available for POST or PUT requests, not GET.

Summary

Use request.form to get data users send via forms.

Access fields by their name attribute.

Check for missing data to handle errors gracefully.

Practice

1. In Flask, which object do you use to access data submitted from an HTML form inside a route function?

easy

A. flask.formdata

B. request.args

C. session.data

D. request.form

Solution

1. Step 1: Recall the Flask object for accessing form data

   When a user submits a form, the data is sent in the HTTP request body, accessible via request.form. request.args is for URL query parameters, session.data and flask.formdata are not valid Flask objects for form data.

2. Final Answer:

   request.form -> Option D

3. Quick Check:

   Form data = request.form [OK]

Hint: Use request.form to get form fields in Flask routes [OK]

Common Mistakes:

• Confusing request.form with request.args
• Trying to access form data from session
• Using incorrect Flask objects like flask.formdata

2. Which of the following is the correct way to get the value of a form field named username inside a Flask route?

easy

A. username = request.form.get('username')

B. username = request.args['username']

C. username = request.form['user']

D. username = request.data['username']

Solution

1. Step 1: Identify the safe way to access form field 'username'

   The correct way to safely get a form field is request.form.get('fieldname'), which returns None if missing. request.args is for URL parameters, not form data; request.form['user'] uses wrong field name; request.data is raw data, not a dict.

2. Final Answer:

   username = request.form.get('username') -> Option A

3. Quick Check:

   Use request.form.get('field') for form fields [OK]

Hint: Use request.form.get('fieldname') to safely access form data [OK]

Common Mistakes:

• Using request.args for form data
• Using wrong field name in request.form
• Trying to index request.data as a dict

3. What will be the output of this Flask route when a POST request with form data {'email': '[e-mail]'} is sent?

from flask import Flask, request
app = Flask(__name__)

@app.route('/submit', methods=['POST'])
def submit():
    email = request.form['email']
    return f"Email received: {email}"

medium

A. KeyError: 'email'

B. Email received:

C. Email received: [e-mail]

D. TypeError: unsupported operand type(s)

Solution

1. Step 1: Trace the route execution with provided form data

   The code accesses the 'email' key directly from request.form, which contains the form data sent. The form data includes 'email' with value '[e-mail]', so no error occurs and the value is returned in the string.

2. Final Answer:

   Email received: [e-mail] -> Option C

3. Quick Check:

   Direct key access with existing field returns value [OK]

Hint: Direct key access works if field exists, else KeyError [OK]

Common Mistakes:

• Assuming request.form is empty
• Expecting get() behavior with direct indexing
• Confusing form data with query parameters

4. Identify the error in this Flask route code that tries to get a form field named age:

from flask import Flask, request
app = Flask(__name__)

@app.route('/age', methods=['POST'])
def age():
    age = request.form.get(age)
    return f"Age: {age}"

medium

A. Using variable age instead of string 'age' in get()

B. Missing methods=['POST'] in route decorator

C. Using request.args instead of request.form

D. Returning age without converting to int

Solution

1. Step 1: Locate the error in request.form.get() call

   The code uses request.form.get(age) where age is a variable not defined yet, causing a NameError. Correct usage requires string key: request.form.get('age').

2. Final Answer:

   Using variable age instead of string 'age' in get() -> Option A

3. Quick Check:

   Use string keys in request.form.get('field') [OK]

Hint: Always quote form field names as strings in get() [OK]

Common Mistakes:

• Passing variable instead of string key
• Forgetting to specify POST method
• Using request.args for form data

5. You want to create a Flask route that safely handles a form submission with optional field nickname. If the field is missing, it should return "No nickname provided". Which code snippet correctly implements this?

hard

A. nickname = request.form['nickname']
if not nickname:
return "No nickname provided"
return f"Nickname: {nickname}"

B. nickname = request.form.get('nickname')
if nickname is None:
return "No nickname provided"
return f"Nickname: {nickname}"

C. nickname = request.args.get('nickname')
if nickname == '':
return "No nickname provided"
return f"Nickname: {nickname}"

D. nickname = request.form.get('nickname', '')
if nickname == None:
return "No nickname provided"
return f"Nickname: {nickname}"

Solution

1. Step 1: Select code snippet for safe optional form field handling

   request.form.get('nickname') returns None if missing, avoiding KeyError. Compare with is None to return fallback. Others fail: B uses direct indexing (KeyError if missing); C uses request.args (wrong for form); D defaults to '' so == None fails.

2. Final Answer:

   nickname = request.form.get('nickname') if nickname is None: return "No nickname provided" return f"Nickname: {nickname}" -> Option B

3. Quick Check:

   Use get() and check None for optional form fields [OK]

Hint: Use get() and check None to handle missing form fields safely [OK]

Common Mistakes:

• Using direct indexing without checking existence
• Using request.args for form data
• Comparing default '' with None incorrectly