Accessing form data in Flask

Introduction

We use form data to get information users type into a web form. Accessing this data lets our app respond to user input.

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

When collecting feedback from a contact form on a website.

When processing search queries entered by users.

When users fill out a registration form to create an account.

Syntax

Flask

from flask import request

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

request.form holds the form data sent by the user.

You access each form field by its 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]')

Convert all form data into a Python dictionary.

Flask

all_data = request.form.to_dict()

Sample Program

This Flask app shows a simple form asking for a name. When submitted, it reads the name from the form data and greets the user.

Flask

from flask import Flask, request

app = Flask(__name__)

@app.route('/', methods=['GET'])
def form():
    return '''
    <form method="POST" action="/submit">
      <label for="name">Name:</label>
      <input type="text" id="name" name="name">
      <button type="submit">Send</button>
    </form>
    '''

@app.route('/submit', methods=['POST'])
def submit():
    name = request.form['name']
    return f'Hello, {name}! Your form was received.'

if __name__ == '__main__':
    app.run(debug=True)

Important Notes

Always check the HTTP method is POST before accessing form data.

Use request.form.get() to avoid errors if a field is missing.

Form field names must match the keys you use to access data.

Summary

Use request.form to get data sent by a form.

Access fields by their name attribute.

Handle missing fields safely with get().

Practice

1. In Flask, which object do you use to access data sent from an HTML form using POST method?

easy

A. request.form

B. request.args

C. request.data

D. request.json

Solution

1. Step 1: Understand form data submission

   When a form is submitted with method POST, data is sent in the request body.

2. Step 2: Identify Flask object for form data

   Flask provides request.form to access form fields sent via POST.

3. Final Answer:

   request.form -> Option A

4. Quick Check:

   Form data = request.form [OK]

Hint: Use request.form to get POST form data in Flask [OK]

Common Mistakes:

• Using request.args for POST form data
• Trying to access form data with request.json
• Using request.data which is raw bytes

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

easy

A. request.args['username']

B. request.form['username']

C. request.form.get('username')

D. request.json['username']

Solution

1. Step 1: Access form field safely

   Using request.form.get('username') safely returns the value or None if missing.

2. Step 2: Compare other options

   request.form['username'] works but raises error if field missing; C and D are for query params and JSON, not form data.

3. Final Answer:

   request.form.get('username') -> Option C

4. Quick Check:

   Safe form access = request.form.get() [OK]

Hint: Use get() to avoid errors if field missing [OK]

Common Mistakes:

• Using request.args for form POST data
• Using [] without checking if field exists
• Trying to get form data from request.json

3. What will be the output of this Flask route when a form with field email is submitted?

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

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

medium

A. Email received: None (if form does not send email field)

B. Email received: [e-mail] (if form sends email=[e-mail])

C. KeyError exception raised

D. Email received: '' (empty string)

Solution

1. Step 1: Understand request.form.get behavior

   It returns the value if field exists, else None.

2. Step 2: Analyze given form submission

   If form sends email=[e-mail], email variable gets that string.

3. Final Answer:

   Email received: [e-mail] (if form sends email=[e-mail]) -> Option B

4. Quick Check:

   request.form.get returns value or None [OK]

Hint: request.form.get returns value or None if missing [OK]

Common Mistakes:

• Expecting KeyError when using get()
• Assuming empty string if field missing
• Confusing request.args with request.form

4. Identify the error in this Flask code snippet 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['age']
    return f"Age is {age}"

medium

A. Using request.form['age'] can raise KeyError if field missing

B. Missing import of request object

C. Route method should be GET instead of POST

D. Using f-string inside return is invalid

Solution

1. Step 1: Check how form data is accessed

   Using request.form['age'] raises KeyError if 'age' field is missing.

2. Step 2: Suggest safer alternative

   Use request.form.get('age') to avoid exceptions if field is missing.

3. Final Answer:

   Using request.form['age'] can raise KeyError if field missing -> Option A

4. Quick Check:

   Accessing form with [] risks KeyError [OK]

Hint: Use get() to avoid KeyError on missing form fields [OK]

Common Mistakes:

• Assuming request.form['age'] never fails
• Confusing GET and POST methods
• Thinking f-strings are invalid in return

5. You want to safely get a form field color with a default value blue if the field is missing. Which Flask code snippet correctly does this?

hard

A. color = request.form['color'] or 'blue'

B. color = request.json.get('color', 'blue')

C. color = request.args.get('color', 'blue')

D. color = request.form.get('color', 'blue')

Solution

1. Step 1: Understand default value usage

   The get() method accepts a second argument as default if key missing.

2. Step 2: Choose correct data source

   Form data is in request.form, so use request.form.get('color', 'blue').

3. Final Answer:

   color = request.form.get('color', 'blue') -> Option D

4. Quick Check:

   Use get(key, default) for safe form access [OK]

Hint: Use get('field', default) to provide fallback value [OK]

Common Mistakes:

• Using request.args for form POST data
• Using [] without default causes error
• Trying to get form data from request.json